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

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

مقدمه

Distance Matrix API (Legacy) سرویسی است که درخواست HTTPS حاوی مبدأ و مقصد را برای حالت حمل‌ونقل مشخصی می‌پذیرد. برای هر ترکیب مبدأ و مقصد، مسافت و مدت سفر را برمی‌گرداند.

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

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

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

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

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

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

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

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

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

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

  • A به C
  • الف تا د
  • ب تا پ
  • 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 بارگیری کنید، در آنجا می‌توانید دستورالعمل‌های نصب و کد نمونه را نیز پیدا کنید.

قدم بعدی چیست