نمای کلی Directions API (Legacy).

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

API مربوط به مسیرها (Legacy) سرویسی است که درخواست HTTP را می‌پذیرد و مسیرهای بین مکان‌ها را با فرمت JSON یا XML برمی‌گرداند.

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

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

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

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

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

نحوه عملکرد API مسیرها

API مربوط به مسیرها (Directions API) هنگام محاسبه مسیرها، کارآمدترین مسیرها را برمی‌گرداند. حاصلضرب، عناصر سفر زیر را هنگام تعیین کارآمدترین مسیر در نظر می‌گیرد:

  • زمان سفر (اولیه)
  • فاصله
  • تعداد چرخش‌ها

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

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

منابع

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

منابع داده داده‌ها بازگردانده شدند قالب بازگشتی
مسیرها

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

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

نحوه استفاده از API مسیرها

۱ آماده شوید. با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی که در ادامه آمده است را تکمیل کنید.
۲ نسخه آزمایشی را امتحان کنید وقتی کلید API و پروژه ابری را داشته باشید، می‌توانید نسخه آزمایشی مسیرها را به صورت رایگان امتحان کنید. به نسخه آزمایشی API مسیرها مراجعه کنید.
۳ ساخت یک درخواست درخواست‌های نمونه را ببینید و درباره گزینه‌های موجود، مانند حالت‌های سفر، نقاط مسیر و محدودیت‌های مسیر، اطلاعات کسب کنید. به نمونه‌های مسیرها مراجعه کنید.
۴ اصول اولیه پاسخ را درک کنید پاسخ‌های داده را بررسی کنید تا برای استفاده از داده‌های مسیرها در برنامه خود آماده شوید. برای جزئیات بیشتر به پاسخ‌های مسیرها مراجعه کنید.
۵ داده‌های مسیر را در برنامه خودتان بگنجانید! با استفاده از این داده‌ها می‌توانید مسافت و زمان سفر را محاسبه کنید.

کتابخانه‌های کلاینت موجود

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

کلاینت جاوا، کلاینت پایتون، کلاینت گو و کلاینت نود.جی‌اس برای سرویس‌های نقشه‌های گوگل، کتابخانه‌های کلاینتی هستند که توسط جامعه پشتیبانی می‌شوند و تحت مجوز آپاچی ۲.۰ متن‌باز می‌باشند. آن‌ها را از گیت‌هاب دانلود کنید، جایی که می‌توانید دستورالعمل‌های نصب و نمونه کد را نیز پیدا کنید.

قدم بعدی چیست؟