نسخه نمایشی Directions API (قدیمی)

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

این نسخه نمایشی به شما نشان می‌دهد که چگونه از Directions API (قدیمی) برای دریافت مجموعه‌ای از مسیرهای رانندگی از یک مکان به مکان دیگر استفاده کنید. می‌توانید این نسخه نمایشی را بدون هزینه اجرا کنید. اجرای این نسخه نمایشی به‌تنهایی از سهمیه ماهانه شما فراتر نمی‌رود.

برای استفاده از Directions API (قدیمی)، مراحل راه‌اندازی لازم را با کلیک کردن روی زبانه‌های زیر تکمیل کنید:

مرحله ۱

کنسول

  1. در کنسول Google Cloud، در صفحه انتخابگر پروژه، روی ایجاد پروژه کلیک کنید تا ایجاد پروژه Cloud جدیدی را شروع کنید.

    به صفحه انتخابگر پروژه بروید

  2. مطمئن شوید که صورت‌حساب برای پروژه Cloud شما فعال باشد. مطمئن شوید که صدور صورت‌حساب برای پروژه‌تان فعال باشد.

    Google Cloud دوره آزمایشی با هزینه ۰٫۰۰ دلار ارائه می‌دهد. دوره آزمایشی پس‌از ۹۰ روز یا پس‌از اینکه حساب ۳۰۰ دلار هزینه جمع کرد، هرکدام زودتر باشد، منقضی می‌شود. هرزمان خواستید لغو کنید. برای اطلاعات بیشتر، اعتبارات حساب صورت‌حساب و صورت‌حساب را ببینید.

کیت توسعه نرم‌افزار Cloud

gcloud projects create "PROJECT"

درباره کیت توسعه نرم‌افزار Google Cloud ، نصب کیت توسعه نرم‌افزار Cloud ، و فرمان‌های زیر بیشتر بخوانید:

مرحله ۲

برای استفاده از Google Maps Platform، باید میاناهای برنامه‌سازی کاربردی یا کیت‌های توسعه نرم‌افزاری را که قصد دارید با پروژه‌تان استفاده کنید فعال کنید.

کنسول

فعال کردن Directions API (قدیمی)

کیت توسعه نرم‌افزار Cloud

gcloud services enable \
    --project "PROJECT" \
    "directions-backend.googleapis.com"

درباره کیت توسعه نرم‌افزار Google Cloud ، نصب کیت توسعه نرم‌افزار Cloud ، و فرمان‌های زیر بیشتر بخوانید:

مرحله ۳

این مرحله فقط فرایند ایجاد کلید میانای API را طی می‌کند. اگر از کلید میانای API خود در تولید استفاده می‌کنید، اکیداً توصیه می‌کنیم کلید میانای API خود را محدود کنید. می‌توانید اطلاعات بیشتری در صفحه استفاده از کلیدهای میانای API مختص محصول پیدا کنید.

کلید میانای برنامه‌سازی کاربردی شناسه یکتایی است که درخواست‌های مرتبط با پروژه شما را برای اهداف استفاده و صدور صورت‌حساب اصالت‌سنجی می‌کند. باید حداقل یک کلید میانای برنامه‌سازی کاربردی مرتبط با پروژه‌تان داشته باشید.

برای ایجاد کلید میانای API:

کنسول

  1. به صفحه پلاتفرم Google Maps > اطلاعات کاربری بروید.

    به صفحه «اطلاعات کاربری» بروید

  2. در صفحه اعتبارنامه‌ها، روی ایجاد اعتبارنامه > کلید میانای برنامه‌سازی کاربردی کلیک کنید.
    کادر گفتگوی کلید میانای API ایجاد شد کلید میانای API جدیداً ایجادشده را نمایش می‌دهد.
  3. روی بستن کلیک کنید.
    کلید میانای API جدید در صفحه اطلاعات کاربری در بخش کلیدهای میانای API فهرست شده است.
    (به‌خاطر داشته باشید که قبل‌از استفاده از کلید میانای API در تولید، آن را محدود کنید.)

کیت توسعه نرم‌افزار Cloud

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

درباره کیت توسعه نرم‌افزار Google Cloud ، نصب کیت توسعه نرم‌افزار Cloud ، و فرمان‌های زیر بیشتر بخوانید:

دریافت مسیرها

برای دریافت مسیرهای رانندگی از «دیزنی‌لند» به «استودیوهای یونیورسال، هالیوود» در قالب JSON، نشانی وب را در مرورگر وب خود وارد کنید و YOUR_API_KEY را با کلید میانای برنامه‌سازی کاربردی خود جایگزین کنید:

https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood&key=YOUR_API_KEY

باید پاسخ JSON زیر را دریافت کنید:

    {
       "geocoded_waypoints" : [
          {
             "geocoder_status" : "OK",
             "place_id" : "ChIJRVY_etDX3IARGYLVpoq7f68",
             "types" : [
                "bus_station",
                "transit_station",
                "point_of_interest",
                "establishment"
             ]
          },
          {
             "geocoder_status" : "OK",
             "partial_match" : true,
             "place_id" : "ChIJp2Mn4E2-woARQS2FILlxUzk",
             "types" : [ "route" ]
          }
       ],
       "routes" : [
          {
             "bounds" : {
                "northeast" : {
                   "lat" : 34.1330949,
                   "lng" : -117.9143879
                },
                "southwest" : {
                   "lat" : 33.8068768,
                   "lng" : -118.3527671
                }
             },
             "copyrights" : "Map data ©2016 Google",
             "legs" : [
                {
                   "distance" : {
                      "text" : "35.9 mi",
                      "value" : 57824
                   },
                   "duration" : {
                      "text" : "51 mins",
                      "value" : 3062
                   },
                   "end_address" : "Universal Studios Blvd, Los Angeles, CA 90068, USA",
                   "end_location" : {
                      "lat" : 34.1330949,
                      "lng" : -118.3524442
                   },
                   "start_address" : "Disneyland (Harbor Blvd.), S Harbor Blvd, Anaheim, CA 92802, USA",
                   "start_location" : {
                      "lat" : 33.8098177,
                      "lng" : -117.9154353
                   },

      ... Additional results shortened in this example[] ...


             "overview_polyline" : {
                "points" : "knjmEnjunUbKCfEA?_@]@kMBeE@qIIoF@wH@eFFk@WOUI_@?u@j@k@`@EXLTZHh@Y`AgApAaCrCUd@cDpDuAtAoApA{YlZiBdBaIhGkFrDeCtBuFxFmIdJmOjPaChDeBlDiAdD}ApGcDxU}@hEmAxD}[tt@yNb\\yBdEqFnJqB~DeFxMgK~VsMr[uKzVoCxEsEtG}BzCkHhKWh@]t@{AxEcClLkCjLi@`CwBfHaEzJuBdEyEhIaBnCiF|K_Oz\\
                {MdZwAbDaKbUiB|CgCnDkDbEiE|FqBlDsLdXqQra@kX|m@aF|KcHtLm@pAaE~JcTxh@w\\`v@gQv`@}F`MqK`PeGzIyGfJiG~GeLhLgIpIcE~FsDrHcFfLqDzH{CxEwAbBgC|B}F|DiQzKsbBdeA{k@~\\oc@bWoKjGaEzCoEzEwDxFsUh^wJfOySx[uBnCgCbCoFlDmDvAiCr@eRzDuNxC_EvAiFpCaC|AqGpEwHzFoQnQoTrTqBlCyDnGmCfEmDpDyGzGsIzHuZzYwBpBsC`CqBlAsBbAqCxAoBrAqDdDcNfMgHbHiPtReBtCkD|GqAhBwBzBsG~FoAhAaCbDeBvD_BlEyM``@uBvKiA~DmAlCkA|B}@lBcChHoJnXcB`GoAnIS~CIjFDd]A|QMlD{@jH[vAk@`CoGxRgPzf@aBbHoB~HeMx^eDtJ}BnG{DhJU`@mBzCoCjDaAx@mAnAgCnBmAp@uAj@{Cr@wBPkB@kBSsEW{GV}BEeCWyAWwHs@qH?
                cIHkDXuDn@mCt@mE`BsH|CyAp@}AdAaAtAy@lBg@pCa@jE]fEcBhRq@pJKlCk@hLFrB@lD_@xCeA`DoBxDaHvM_FzImDzFeCpDeC|CkExDiJrHcBtAkDpDwObVuCpFeCdHoIl\\uBjIuClJsEvMyDbMqAhEoDlJ{C|J}FlZuBfLyDlXwB~QkArG_AnDiAxC{G|OgEdLaE`LkBbEwG~KgHnLoEjGgDxCaC`BuJdFkFtCgCnBuClD_HdMqEzHcBpB_C|BuEzCmPlIuE|B_EtDeBhCgAdCw@rCi@|DSfECrCAdCS~Di@jDYhA_AlC{AxCcL`U{GvM_DjFkBzBsB`BqDhBaEfAsTvEmEr@iCr@qDrAiFnCcEzCaE~D_@JmFdGQDwBvCeErEoD|BcFjC}DbEuD~D`@Zr@h@?d@Wr@}@vAgCbEaHfMqA`Cy@dAg@bAO`@gCi@w@W"
             },
             "summary" : "I-5 N and US-101 N",
             "warnings" : [],
             "waypoint_order" : []
          }
       ],
       "status" : "OK"
    }

تبریک می‌گوییم! با موفقیت Directions API (Legacy) را راه‌اندازی و فراخوانی کرده‌اید تا مسیرها را دریافت کنید.

درحال پاک‌سازی

می‌توانید پروژه Google Cloud خود را حذف کنید تا صدور صورت‌حساب برای همه منابع استفاده‌شده در آن پروژه متوقف شود.

  1. در کنسول Google Cloud، به صفحه مدیریت منابع بروید:

    رفتن به صفحه «مدیریت منابع»

  2. اگر پروژه‌ای که قصد حذف آن را دارید به سازمانی پیوست شده است، فهرست سازمان را در بالای صفحه انتخاب و ازهم باز کنید.
  3. در فهرست پروژه، پروژه‌ای را که می‌خواهید حذف شود انتخاب کنید و روی حذف کلیک کنید.
  4. در کادر گفتگو، شناسه پروژه را تایپ کنید و برای حذف پروژه روی خاموش کردن کلیک کنید.

مراحل بعدی

  • با راه‌اندازی پروژه Google Cloud، توسعه را با Directions API (قدیمی) شروع کنید:

    راه‌اندازی در کنسول Cloud

  • برای مشاهده فهرست همه پارامترها هنگام ساختن درخواست HTTP مربوط به Directions API (قدیمی):

    دریافت مسیر

  • با کتابخانه‌های مشتری ما که پیاده‌سازی‌های ساده و بومی کارهای رایج مانند اصالت‌سنجی، محدود کردن درخواست، و تکرار خودکار را ارائه می‌دهند، نحوه کدنویسی را بیاموزید. ‫Directions API (قدیمی) در Java Client،‏ Python Client،‏ Go Client، و Node.js Client برای Google Maps Services دردسترس است.