چرا از Distance Matrix API استفاده کنیم؟
میتوانید از Distance Matrix API برای کمک به تعیین کارآمدترین مسیرهای سفر بین مبدا و مقصدهای متعدد استفاده کنید. مثلاً چه کارگرانی را به محل های کاریابی بفرستیم یا از کدام انبارها بسته ها را ارسال کنیم.
با Distance Matrix API چه کاری می توانید انجام دهید
با استفاده از Distance Matrix API، می توانید مسافت و زمان سفر را برای ماتریسی از مبدا و مقصد ارائه دهید. شما می توانید چندین گزینه از جمله حالت حمل و نقل، مانند رانندگی، دوچرخه سواری، حمل و نقل یا پیاده روی، و همچنین حالت های حمل و نقل مانند اتوبوس، مترو، قطار، تراموا یا راه آهن را مشخص کنید.
Distance Matrix 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 را به همراه داده هایی که برمی گرداند خلاصه می کند.
منابع داده | داده ها برگردانده شد | فرمت بازگشت |
---|---|---|
ماتریس فاصله مبدا و مقصد را به شکل شناسه مکان، آدرس، یا مختصات طول و عرض جغرافیایی ارائه دهید. |
|
|
نحوه استفاده از Distance Matrix API
1 | راه اندازی شود. | با راهاندازی پروژه Google Cloud خود شروع کنید و دستورالعملهای راهاندازی را تکمیل کنید. |
2 | درخواست ماتریس فاصله را امتحان کنید | هنگامی که یک کلید API دارید، می توانید آزمایش API ماتریس فاصله را مستقیماً از مرورگر خود شروع کنید. برای مثال، درخواستهای نمونه را در راهنمای شروع به کار ببینید. |
3 | درخواست پیچیده تری بنویسید | درخواستی را امتحان کنید که مبدا و مقصد متعددی را ارائه میکند. با پارامترهای اختیاری برای محدود کردن محاسبات، مانند زمان حرکت مشخص یا محدودیتهای مسیر آشنا شوید. پارامترهای اختیاری را در راهنمای درخواست و پاسخ ماتریس فاصله مشاهده کنید. |
4 | اصول پاسخگویی را درک کنید | برای آماده شدن برای استفاده از داده های ماتریس فاصله برای برنامه خود، پاسخ های داده را کاوش کنید. برای جزئیات بیشتر به پاسخ های ماتریس فاصله مراجعه کنید. |
5 | داده های ماتریس فاصله را در برنامه خود بگنجانید! | می توانید از این داده ها برای محاسبه مسافت و زمان سفر استفاده کنید. |
کتابخانه های مشتری موجود
این API را به زبان انتخابی خود از طریق یکی از کتابخانه های سرویس گیرنده زیر فراخوانی کنید:
- Java Client برای خدمات Google Maps
- کلاینت پایتون برای خدمات نقشه های گوگل
- Go Client برای خدمات Google Maps
- Node.js Client برای خدمات Google Maps
Java Client، Python Client، Go Client و Node.js Client برای سرویسهای Google Maps، کتابخانههای مشتری پشتیبانی شده توسط جامعه هستند که تحت مجوز Apache 2.0 منبع باز هستند. آنها را از GitHub دانلود کنید، جایی که می توانید دستورالعمل های نصب و کد نمونه را پیدا کنید.
بعدش چی
- استفاده از Distance Matrix را شروع کنید : به Get Started بروید.
- با نمونه درخواستها و پاسخها شروع کنید : به درخواست و پاسخ ماتریس فاصله بروید
- بهترین شیوه ها را دنبال کنید : به بهترین روش های خدمات وب بروید.