مرور کلی API مسیرها (قدیمی) (قدیمی)

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

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

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

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

با Directions API (Legacy) چه ​​کارهایی می‌توان انجام داد؟

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

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

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

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

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

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

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

منابع

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

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

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

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

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

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

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

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

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

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