نمای کلی API مسیرها

Directions API سرویسی است که درخواست HTTP را می‌پذیرد و مسیرهای با قالب JSON یا XML را بین مکان‌ها برمی‌گرداند.

چرا از Directions API استفاده کنید

با Directions API، می‌توانید برای چندین حالت حمل‌ونقل مانند حمل‌ونقل، رانندگی، پیاده‌روی یا دوچرخه‌سواری مسیرها را دریافت کنید.

با Directions API چه کاری می توانید انجام دهید؟

با Directions API، می‌توانید جهت‌ها را بین مکان‌ها محاسبه کنید، از جمله جزئیات زیر:

  • دستورالعمل برای چندین روش حمل و نقل، از جمله حمل و نقل، رانندگی، پیاده روی یا دوچرخه سواری.
  • جهت های چند بخشی با استفاده از یک سری از ایستگاه های بین راه.
  • مبدا، مقصد، و نقاط راه را به روش‌های مختلف، از جمله به‌عنوان رشته‌های متنی (مثلاً «Chicago, IL» یا «Darwin, NT, Australia»)، شناسه‌های مکان یا مختصات طول و عرض جغرافیایی مشخص کنید.

نحوه عملکرد Directions API

Directions API کارآمدترین مسیرها را هنگام محاسبه جهت ها برمی گرداند. عوامل محصول در عناصر سفر زیر هنگام تعیین کارآمدترین مسیر:

  • زمان سفر (اولیه)
  • فاصله
  • تعداد نوبت

درخواست مثال زیر مسیرهای رانندگی از تورنتو، انتاریو به مونترال، کبک را در قالب JSON برمی گرداند: 

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

منابع

جدول زیر منابع موجود از طریق Directions API را به همراه داده هایی که برمی گرداند خلاصه می کند.

منابع داده داده ها برگردانده شد فرمت بازگشت
مسیرها

مبدا و مقصد را به شکل شناسه مکان، آدرس، یا مختصات طول و عرض جغرافیایی ارائه کنید. برای جزئیات بیشتر به پارامترهای مورد نیاز مراجعه کنید.

 مسیرهای دقیق، به مسیرها، پاها و مراحل تقسیم شده است. برای جزئیات بیشتر به پاسخ‌های دستورالعمل‌ها مراجعه کنید.
  • JSON
  • XML

نحوه استفاده از Directions API

1 راه اندازی شود. با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی را تکمیل کنید.
2 نسخه ی نمایشی را امتحان کنید هنگامی که یک کلید API و یک پروژه ابری دارید، نسخه ی نمایشی مسیرها را بدون پرداخت هزینه امتحان کنید. نسخه ی نمایشی API Directions را ببینید.
3 درخواست بسازید نمونه درخواست‌ها را ببینید و در مورد گزینه‌های موجودی که می‌توانید ارائه کنید، مانند حالت‌های سفر، ایستگاه‌های بین راه، و محدودیت‌های مسیر، اطلاعات کسب کنید. نمونه‌های دستورالعمل‌ها را ببینید.
4 اصول پاسخگویی را درک کنید برای آماده شدن برای استفاده از داده های مسیرها برای برنامه خود، پاسخ های داده را کاوش کنید. برای جزئیات بیشتر به پاسخ‌های دستورالعمل‌ها مراجعه کنید.
5 داده های جهت را در برنامه خود بگنجانید! می توانید از این داده ها برای محاسبه مسافت و زمان سفر استفاده کنید.

کتابخانه های مشتری موجود

این API را به زبان انتخابی خود از طریق یکی از کتابخانه های سرویس گیرنده زیر فراخوانی کنید:

Java Client، Python Client، Go Client و Node.js Client برای سرویس‌های Google Maps، کتابخانه‌های مشتری پشتیبانی شده توسط جامعه هستند که تحت مجوز Apache 2.0 منبع باز هستند. آنها را از GitHub دانلود کنید، جایی که می توانید دستورالعمل های نصب و کد نمونه را پیدا کنید.

بعدش چی