نمای کلی Directions API (قدیمی)

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

‫Directions API (Legacy) سرویسی است که درخواست 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 (Legacy) را به‌همراه داده‌هایی که برمی‌گرداند خلاصه می‌کند.

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

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

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

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

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

کتابخانه‌های کارخواه دردسترس

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

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

قدم بعدی چیست