مرجع سریع Distance Matrix API

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

Distance Matrix API: حقایق کلیدی

  • محصول: Distance Matrix API
  • با این نام‌ها نیز شناخته می‌شود: Distance Matrix API (Legacy)،‏ Distance Matrix (Legacy)
  • دسته: مسیرها
  • پلاتفرم: سرویس وب (REST)
  • اجرا در: سرور (کد پسین)
  • مرحله راه‌اندازی: GA
  • چرخه حیات: قدیمی
  • جایگزین‌شده با: Routes API
  • نمای کلی: نمای کلی Distance Matrix API

Distance Matrix API: when to use it

در موارد زیر از Distance Matrix API استفاده کنید:

  • پروژه موجودی را نگهداری می‌کنید که ازقبل Distance Matrix API (قدیمی) در آن فعال است و /maps/api/distancematrix را فراخوانی می‌کند.
  • به فاصله و زمان سفر بین هریک از چند مبدأ و هریک از چند مقصد از سرور نیاز دارید.
  • برای رانندگی، بااستفاده از departure_time و traffic_model اختیاری، به مدت زمان در ترافیک نیاز دارید.

در شرایط زیر از Distance Matrix API استفاده نکنید:

  • درحال شروع پروژه Google Cloud جدیدی هستید. از اکتبر ۲۰۲۶، Distance Matrix API (قدیمی) را نمی‌توان برای پروژه‌های جدید فعال کرد. درعوض از Routes API استفاده کنید.
  • به ویژگی‌های جدید یا جدول مسیرها با حداکثر ۶۲۵ عنصر با پاسخ‌های جاری‌شده (computeRouteMatrix) نیاز دارید. به‌جای آن، از Routes API استفاده کنید.
  • به مسیر کامل با مراحل و چندخطی‌های بین نقاط نیاز دارید، نه فقط مقادیر فاصله و مدت. درعوض از Routes API استفاده کنید.

Distance Matrix API: setup

Distance Matrix API: common mistakes

  • مشکل: هر درخواست سمت سرور به ۱۰۰ عنصر (مبدأ × مقصد) و ۲۵ مبدأ یا ۲۵ مقصد محدود است. درخواست‌های بزرگ‌تر MAX_ELEMENTS_EXCEEDED یا MAX_DIMENSIONS_EXCEEDED را برمی‌گردانند. راه‌حل: ماتریس را به درخواست‌هایی با حداکثر ۱۰۰ عنصر و ۲۵ مبدأ یا مقصد تقسیم کنید. /maps/documentation/distance-matrix/usage-and-billing#usage-limits را ببینید.
  • مشکل: اگر departure_time را مشخص نکنید، مسیر و مدت‌زمان براساس میانگین ترافیک مستقل از زمان محاسبه می‌شود و هیچ duration_in_traffic برگردانده نمی‌شود. نتایج ممکن است درطول زمان تغییر کند. اصلاح: برای دریافت مدت‌های آگاه از ترافیک، departure_time را روی now یا زمان آینده با mode=driving تنظیم کنید. توجه داشته باشید که درخواست‌های ترافیک با نرخ بالاتری صورت‌حساب می‌شود. /maps/documentation/distance-matrix/distance-matrix را ببینید.
  • مشکل: پارامتر units فقط نوشتار را در فیلدهای فاصله تغییر می‌دهد. مقدار فاصله همیشه به متر است. اصلاح: distance.value را به‌صورت متر بخوانید یا از distance.text برای نمایش استفاده کنید. /maps/documentation/distance-matrix/distance-matrix را ببینید.
  • مشکل: فراخوانی Distance Matrix API (قدیمی) از پروژه‌ای که در آن فعال نشده است، REQUEST_DENIED را در status و error_message پیونددهی به LegacyApiNotActivatedMapError برمی‌گرداند. دستیارهای هوش مصنوعی اغلب به‌طور پیش‌فرض کد API قدیمی تولید می‌کنند. راه‌حل: به Routes API computeRouteMatrix (با سرصفحه X-Goog-FieldMask) منتقل شوید. API قدیمی را فقط ازطریق فرم و به‌عنوان اقدامی کوتاه‌مدت فعال کنید. /maps/legacy#LegacyApiNotActivatedMapError را ببینید.