نمای کلی Distance Matrix API

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

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

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

با Distance Matrix API چه کاری می توانید انجام دهید

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

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

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

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

نحوه عملکرد Distance Matrix API

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

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

  • A تا C
  • الف تا د
  • ب تا ج
  • ب تا د

مثال زیر یک درخواست برای دو مبدا را نشان می دهد: واشنگتن، دی سی و بوستون، با یک مقصد، شهر نیویورک، نیویورک، در قالب 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 را به همراه داده هایی که برمی گرداند خلاصه می کند.

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

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

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

نحوه استفاده از Distance Matrix API

1 راه اندازی شود. با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی را تکمیل کنید.
2 درخواست ماتریس فاصله را امتحان کنید هنگامی که یک کلید API دارید، می توانید آزمایش API ماتریس فاصله را مستقیماً از مرورگر خود شروع کنید. برای مثال، درخواست‌های نمونه را در راهنمای شروع به کار ببینید.
3 درخواست پیچیده تری بنویسید درخواستی را امتحان کنید که مبدا و مقصد متعددی را ارائه می‌کند. با پارامترهای اختیاری برای محدود کردن محاسبات، مانند زمان حرکت مشخص یا محدودیت‌های مسیر آشنا شوید. پارامترهای اختیاری را در راهنمای درخواست و پاسخ ماتریس فاصله مشاهده کنید.
4 اصول پاسخگویی را درک کنید برای آماده شدن برای استفاده از داده های ماتریس فاصله برای برنامه خود، پاسخ های داده را کاوش کنید. برای جزئیات بیشتر به پاسخ های ماتریس فاصله مراجعه کنید.
5 داده های ماتریس فاصله را در برنامه خود بگنجانید! می توانید از این داده ها برای محاسبه مسافت و زمان سفر استفاده کنید.

کتابخانه های مشتری موجود

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

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

بعدش چی