این نسخه نمایشی به شما نشان میدهد که چگونه از Directions API (قدیمی) برای دریافت مجموعهای از مسیرهای رانندگی از یک مکان به مکان دیگر استفاده کنید. میتوانید این نسخه نمایشی را بدون هزینه اجرا کنید. اجرای این نسخه نمایشی بهتنهایی از سهمیه ماهانه شما فراتر نمیرود.
قبلاز شروع
برای استفاده از Directions API (قدیمی)، مراحل راهاندازی الزامی زیر را تکمیل کنید:
مرحله ۱: راهاندازی پروژه
کنسول
-
در کنسول Google Cloud، در صفحه انتخابگر پروژه، روی ایجاد پروژه کلیک کنید تا ایجاد پروژه Cloud جدید شروع شود.
-
مطمئن شوید که صورتحساب برای پروژه Cloud شما فعال است. مطمئن شوید که صورتحساب برای پروژهتان فعال است.
Google Cloud دوره آزمایشی با هزینه ۰٫۰۰ دلار ارائه میدهد. دوره آزمایشی در پایان ۹۰ روز یا پساز اینکه حساب ۳۰۰ دلار هزینه جمع کرد، هرکدام زودتر باشد، منقضی میشود. هرزمان خواستید لغو کنید. برای اطلاعات بیشتر، اعتبارات حساب صورتحساب و صورتحساب را ببینید.
کیت توسعه نرمافزار Cloud
gcloud projects create "PROJECT"
درباره کیت توسعه نرمافزار Google Cloud، نصب کیت توسعه نرمافزار Cloud، و فرمانهای زیر بیشتر بخوانید:
مرحله ۲: فعال کردن میاناهای برنامهسازی کاربردی یا کیتهای توسعه نرمافزار
برای استفاده از Google Maps Platform، باید میاناهای برنامهسازی کاربردی یا کیتهای توسعه نرمافزاری را که قصد دارید با پروژهتان استفاده کنید فعال کنید.
کنسول
کیت توسعه نرمافزار Cloud
gcloud services enable \ --project "PROJECT" \ "directions-backend.googleapis.com"
درباره کیت توسعه نرمافزار Google Cloud، نصب کیت توسعه نرمافزار Cloud، و فرمانهای زیر بیشتر بخوانید:
مرحله ۳: دریافت کلید میانای برنامهسازی کاربردی
این مرحله فقط فرایند ایجاد کلید میانای برنامهسازی کاربردی را طی میکند. اگر از کلید میانای API خود در تولید استفاده میکنید، اکیداً توصیه میکنیم کلید میانای API خود را محدود کنید. میتوانید اطلاعات بیشتری در صفحه استفاده از کلیدهای میانای API مختص محصول پیدا کنید.
کلید میانای برنامهسازی کاربردی شناسه یکتایی است که درخواستهای مرتبط با پروژه شما را برای اهداف استفاده و صدور صورتحساب اصالتسنجی میکند. باید حداقل یک کلید میانای API مرتبط با پروژهتان داشته باشید. برای ایجاد کلید جدید یا افزودن میانای برنامهسازی کاربردی یا کیت توسعه نرمافزار به کلید موجود، این دستورالعملها را دنبال کنید.
کنسول
-
به صفحه پلاتفرم Google Maps > کلیدها و اطلاعات کاربری بروید.
- اگر درخواست شد، پروژهتان را انتخاب کنید.
-
یکی از موارد زیر را انجام دهید:
-
ایجاد کلید جدید:
- روی ایجاد اطلاعات کاربری > کلید میانای API کلیک کنید.
- در پانل ایجاد کلید میانای API، فهرست انتخاب محدودیتهای میانای API را باز کنید.
- هر میانای برنامهسازی کاربردی را که این کلید به آن نیاز ندارد پاک کنید و مطمئن شوید Directions API همچنان انتخاب شده باشد.
- روی ایجاد کردن کلیک کنید. پانل کلید میانای برنامهسازی کاربردی جدیدتان را نمایش میدهد.
-
استفاده از کلید موجود:
- روی نام کلید کلیک کنید.
- در فهرست انتخاب محدودیتهای میانای برنامهسازی کاربردی، Directions API را انتخاب کنید.
- روی ذخیره کلیک کنید.
انتخاب کردن میانای برنامهسازی کاربردی در اینجا آن را فعال نمیکند. مطمئن شوید Directions API در صفحه کتابخانه میانای برنامهسازی کاربردی آن فعال باشد.
-
- برای دیدن رشته کلید در آینده، به صفحه کلیدها و اطلاعات کاربری بروید و روی نمایش کلید برای کلید کلیک کنید.
اگر کنسول با این مراحل متفاوت است، ایجاد کلید میانای برنامهسازی کاربردی و افزودن محدودیتهای کلید میانای برنامهسازی کاربردی را در اسناد Google Cloud ببینید.
کیت توسعه نرمافزار Cloud
در فرمانهای زیر، PROJECT_ID را با شناسه پروژهتان جایگزین کنید.
-
ایجاد کلید جدید: فرمان زیر را اجرا کنید و DISPLAY_NAME را با نامی برای کلید جایگزین کنید.
gcloud services api-keys create \ --project="PROJECT_ID" \ --display-name="DISPLAY_NAME" \ --api-target=service=directions-backend.googleapis.com
درباره کیت توسعه نرمافزار Google Cloud، نصب کیت توسعه نرمافزار Cloud، و فرمانهای زیر بیشتر بخوانید:
-
استفاده از کلید موجود: فرمان زیر را اجرا کنید و KEY_ID را با شناسه کلید جایگزین کنید. پرچم
--appendمیاناهای برنامهسازی کاربردی را که کلید ازقبل مجاز کرده است حفظ میکند. بدون آن، فرمان جایگزین آنها میشود.gcloud services api-keys update KEY_ID \ --project="PROJECT_ID" \ --append \ --api-target=service=directions-backend.googleapis.com
درباره کیت توسعه نرمافزار Google Cloud، نصب کیت توسعه نرمافزار Cloud، و فرمانهای زیر بیشتر بخوانید:
شناسه کلید، رشته کلید یا نام نمایشی نیست. برای پیدا کردن آن،
gcloud services api-keys list --project="PROJECT_ID"را اجرا کنید. شناسه بخش آخر فیلدnameاست:projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.
برای دیدن رشته کلید،
gcloud services api-keys get-key-string KEY_ID
--project="PROJECT_ID" را اجرا کنید.
دریافت مسیرها
برای دریافت مسیرهای رانندگی از «دیزنیلند» به «استودیوهای یونیورسال» در هالیوود در قالب 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 (Legacy) را راهاندازی و فراخوانی کردید تا مسیرها را دریافت کنید.
درحال پاکسازی
میتوانید پروژه Google Cloud خود را حذف کنید تا صدور صورتحساب برای همه منابع استفادهشده در آن پروژه متوقف شود.
- در کنسول Google Cloud، به صفحه مدیریت منابع بروید:
- اگر پروژهای که قصد دارید حذف کنید به سازمانی پیوست شده است، فهرست سازمان را در بالای صفحه انتخاب و ازهم باز کنید.
- در فهرست پروژه، پروژهای را که میخواهید حذف شود انتخاب کنید و روی حذف کلیک کنید.
- در کادر گفتگو، شناسه پروژه را تایپ کنید و برای حذف پروژه روی خاموش کردن کلیک کنید.
مراحل بعدی
با راهاندازی پروژه Google Cloud، توسعه را با Directions API (قدیمی) شروع کنید:
برای مشاهده فهرست همه پارامترها هنگام ساختن درخواست HTTP برای Directions API (قدیمی):
با کتابخانههای مشتری ما که پیادهسازیهای ساده و بومی برای کارهای رایج مانند اصالتسنجی، محدود کردن درخواست، و تکرار خودکار ارائه میدهند، نحوه کدنویسی را یاد بگیرید. Directions API (Legacy) در Java Client، Python Client، Go Client، و Node.js Client برای Google Maps Services دردسترس است.