نمای کلی Distance Matrix API (قدیمی)

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

مقدمه

«میانای برنامه‌سازی کاربردی ماتریس فاصله» (قدیمی) سرویسی است که درخواست HTTPS حاوی مبدأها و مقصدها را برای حالت حمل‌ونقل معینی می‌پذیرد. برای هر ترکیب مبدأ و مقصد، مسافت و مدت سفر را برمی‌گرداند.

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

می‌توانید از Distance Matrix API (قدیمی) برای کمک به تعیین کارآمدترین مسیرهای سفر بین چندین مبدأ و مقصد احتمالی استفاده کنید. برای مثال، کدام کارگران را به محل کار بفرستید یا بسته‌ها را از کدام انبارها ارسال کنید.

کارهایی که می‌توانید با Distance Matrix API (قدیمی) انجام دهید

با Distance Matrix API (قدیمی)، می‌توانید مسافت و زمان سفر را برای ماتریسی از مبدأها و مقصدها ارائه دهید. می‌توانید چندین گزینه را مشخص کنید، ازجمله حالت حمل‌ونقل، مانند رانندگی، دوچرخه‌سواری، حمل‌ونقل عمومی، یا پیاده‌روی، و همچنین حالت‌های حمل‌ونقل عمومی، مانند اتوبوس، مترو، قطار، تراموا، یا راه‌آهن.

‫Distance Matrix API (قدیمی) اطلاعات را براساس مسیر توصیه‌شده بین نقاط شروع و پایان ارائه می‌دهد. می‌توانید این نوع داده‌های مسافت را درخواست کنید:

  • مسافت برای حالت سفر انتخاب‌شده
  • فاصله به کیلومتر یا مایل
  • مدت سفر تخمینی در ترافیک

نقشه‌ای که مبدأ و مقصدها را روی نقشه و در پاسخ میانای برنامه‌سازی کاربردی نشان می‌دهد

نحوه عملکرد Distance Matrix API (قدیمی)

«میانای برنامه‌سازی کاربردی ماتریس فاصله» (قدیمی) از هر تعداد مبدأ (نقطه شروع) و مقصد استفاده می‌کند و فاصله و زمان سفر بین هر مبدأ و همه مقصدهای درخواستی را برمی‌گرداند، ابتدا با اولین مبدأ در درخواست شروع می‌کند و به‌صورت گام‌به‌گام به مبدأ بعدی می‌رود.

برای مثال، اگر درخواست شما A و B را به‌عنوان مبدأ و C و D را به‌عنوان مقصد مشخص کند، فاصله‌ها و مدت سفر را به‌این‌ترتیب برمی‌گرداند:

  • الف تا ج
  • الف تا ت
  • شرکت‌به‌فرد
  • از B به D

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

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

منابع

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

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

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

  • فاصله و زمان سفر بین هر مبدأ و هر مقصد
  • مدت زمان در ترافیک اگر حالت رانندگی و زمان حرکت را مشخص کرده باشید
  • (قالب) JSON
  • XML

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

۱ راه‌اندازی کردن با راه‌اندازی پروژه Google Cloud شروع کنید و دستورالعمل‌های راه‌اندازی را که در ادامه می‌آید تکمیل کنید.
۲ امتحان کردن درخواست ماتریس فاصله وقتی کلید میانای برنامه‌سازی کاربردی را دریافت کردید، می‌توانید Distance Matrix API (Legacy)‎ را مستقیماً از مرورگرتان آزمایش کنید. برای دیدن نمونه‌ها، به درخواست‌های نمونه در راهنمای شروع به کار مراجعه کنید.
3 نوشتن درخواست پیچیده‌تر درخواستی را امتحان کنید که چندین مبدأ و مقصد را ارائه دهد. درباره پارامترهای اختیاری برای محدود کردن محاسبات، مثل زمان حرکت مشخص، یا محدودیت‌های مسیر بیشتر بدانید. پارامترهای اختیاری را در راهنمای درخواست و پاسخ Distance Matrix (قدیمی) ببینید.
‫۴ آشنایی با اصول اولیه پاسخ پاسخ‌های داده را کاوش کنید تا برای استفاده از داده‌های ماتریس فاصله برای برنامه‌تان آماده شوید. برای جزئیات، پاسخ‌های ماتریس فاصله را ببینید.
۵ داده‌های ماتریس فاصله را در برنامه خودتان بگنجانید! می‌توانید از این داده‌ها برای محاسبه مسافت و زمان سفر استفاده کنید.

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

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

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

قدم بعدی چیست