این نسخه نمایشی نحوه استفاده از Directions API (قدیمی) را برای دریافت مجموعهای از مسیرهای رانندگی از یک مکان به مکان دیگر نشان میدهد. میتوانید این نسخه نمایشی را بدون هزینه اجرا کنید. اجرای این نسخه نمایشی بهتنهایی از سهمیه ماهانه شما فراتر نمیرود.
برای استفاده از «میانای برنامهسازی کاربردی مسیرها» (قدیمی)، مراحل راهاندازی الزامی را با کلیک کردن روی برگههای زیر تکمیل کنید:
مرحله ۱
کنسول
-
در کنسول Google Cloud، در صفحه انتخابگر پروژه، روی ایجاد پروژه کلیک کنید تا ایجاد پروژه جدید Cloud را شروع کنید.
-
مطمئن شوید که صورتحساب برای پروژه Cloud شما فعال است. تأیید کنید که صورتحساب برای پروژه شما فعال است.
Google Cloud دوره آزمایشی با کارمزد ۰٫۰۰ دلار ارائه میدهد. دوره آزمایشی در پایان ۹۰ روز یا پساز اینکه حساب ۳۰۰ دلار هزینه انباشته کند، هرکدام زودتر باشد، منقضی میشود. هرزمان بخواهید میتوانید لغو کنید. برای اطلاعات بیشتر، به اعتبارات حساب صورتحساب و صورتحساب مراجعه کنید.
Cloud SDK
gcloud projects create "PROJECT"
درباره کیت توسعه نرمافزار Google Cloud ، نصب کیت توسعه نرمافزار Cloud ، و دستورات زیر بیشتر بخوانید:
مرحله ۲
برای استفاده از Google Maps Platform، باید میاناهای برنامهسازی کاربردی یا کیتهای توسعه نرمافزاری را که قصد دارید با پروژهتان استفاده کنید فعال کنید.
کنسول
Cloud SDK
gcloud services enable \ --project "PROJECT" \ "directions-backend.googleapis.com"
درباره کیت توسعه نرمافزار Google Cloud ، نصب کیت توسعه نرمافزار Cloud ، و دستورات زیر بیشتر بخوانید:
مرحله ۳
این مرحله فقط فرایند ایجاد «کلید میانای برنامهسازی کاربردی» را طی میکند. اگر از «کلید API» خود در تولید استفاده میکنید، اکیداً توصیه میکنیم «کلید API» خود را محدود کنید. میتوانید اطلاعات بیشتری در صفحه استفاده از کلیدهای API مخصوص محصول پیدا کنید.
کلید API یک شناسه یکتا است که درخواستهای مرتبط با پروژه شما را برای اهداف استفاده و صورتحساب تأیید میکند. باید حداقل یک کلید API مرتبط با پروژه خود داشته باشید.
برای ایجاد کلید API:
کنسول
-
به صفحه پلاتفرم Google Maps > اطلاعات اعتباری بروید.
-
در صفحه اطلاعات اعتباری، روی ایجاد اطلاعات اعتباری > کلید API کلیک کنید.
کادر گفتگوی کلید میانای API ایجاد شد کلید میانای API جدیداً ایجادشده شما را نمایش میدهد. -
روی بستن کلیک کنید.
کلید جدید API در صفحه اطلاعات اعتباری در بخش کلیدهای API فهرست شده است.
(بهیاد داشته باشید که قبلاز استفاده از کلید در دسته هدف تولید، میانای برنامهسازی کاربردی را محدود کنید.)
Cloud SDK
gcloud services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
درباره کیت توسعه نرمافزار Google Cloud ، نصب کیت توسعه نرمافزار Cloud ، و دستورات زیر بیشتر بخوانید:
دریافت مسیرها
برای دریافت مسیر رانندگی از Disneyland به Universal Studios، هالیوود در قالب JSON، نشانی وب را در مرورگر وب خود وارد کنید و YOUR_API_KEY را با «کلید API» خود جایگزین کنید:
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 (قدیمی) را برای دریافت مسیرها راهاندازی و فراخوانی کردهاید.
درحال پاکسازی
میتوانید پروژه Google Cloud خود را حذف کنید تا صورتحساب همه منابع استفادهشده در آن پروژه متوقف شود.
- در کنسول Google Cloud، به صفحه مدیریت منابع بروید:
- اگر پروژهای که قصد دارید حذف کنید به سازمانی پیوست شده است، فهرست سازمان را در بالای صفحه انتخاب و ازهم باز کنید.
- در فهرست پروژه، پروژهای را که میخواهید حذف کنید انتخاب کنید و روی حذف کلیک کنید.
- در چارگوش گفتگو، شناسه پروژه را تایپ کنید و روی خاموش کردن کلیک کنید تا پروژه حذف شود.
مراحل بعدی
با راهاندازی پروژه Google Cloud خود، توسعه با Directions API (قدیمی) را شروع کنید:
برای فهرست همه پارامترها هنگام ساختن درخواست HTTP در Directions API (قدیمی):
با کتابخانههای مشتری ما که پیادهسازیهای ساده و بومی از وظایف رایج مثل اصالتسنجی، محدود کردن درخواست، و تلاش مجدد خودکار ارائه میدهند، با نحوه کدنویسی آشنا شوید. Directions API (قدیمی) در Java Client، Python Client، Go Client، و Node.js Client برای «خدمات Google Maps» دردسترس است.