Distance Matrix API

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

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

این API از ماتریس‌هایی تا 100 مبدأ در برابر 100 مقصد در یک درخواست پشتیبانی می‌کند که تا 10,000 جفت مبدأ-مقصد در هر فراخوانی را ممکن می‌سازد. ماتریس‌ها لازم نیست مربع باشند: می‌توانید 1 مبدأ در برابر 100 مقصد برای جستجوی نزدیک‌ترین مکان ارسال کنید یا 50 در برابر 50 برای تخصیص کامل ناوگان به مشتری.

Matrix API از رانندگی، پیاده‌روی، دوچرخه‌سواری و حمل‌ونقل عمومی پشتیبانی می‌کند. حالت سفر به ازای هر درخواست تنظیم می‌شود. همه جفت‌ها در یک درخواست از همان حالت استفاده می‌کنند. اگر به نتایج حالت مختلط نیاز دارید، درخواست‌های جداگانه برای هر حالت ارسال کنید و پاسخ‌ها را در برنامه‌تان ادغام کنید.

Matrix API به‌طور پیش‌فرض از سرعت‌های جریان آزاد جاده که نماینده شرایط سفر معمولی هستند استفاده می‌کند. فواصل زمانی تنظیم‌شده بر اساس ترافیک بلادرنگ در طرح‌های واجد شرایط در دسترس است. پارامتر departure_time را روی یک برچسب زمانی آینده تنظیم کنید تا بر اساس الگوهای ترافیک تاریخی تخمین‌های سفر به تفکیک ساعت روز دریافت کنید.

موقعیت استعلام واحد خود را به عنوان مبدأ و فهرست مکان‌های کاندیدا را به عنوان مقصد ارسال کنید. این API زمان سفر و مسافت از نقطه استعلام تا هر کاندیدا را در یک فراخوانی برمی‌گرداند. پاسخ را بر اساس فاصله زمانی مرتب کنید تا نزدیک‌ترین گزینه را بیابید. این روش به طور قابل توجهی کارآمدتر از فراخوانی Directions API در یک حلقه برای هر کاندیدا است.