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-backend.googleapis.com - اصالتسنجی: کلید میانای برنامهسازی کاربردی
- شروع به کار: راهاندازی Distance Matrix API
- مرجع: مرجع Distance Matrix API
- قیمتگذاری: استفاده و صدور صورتحساب Distance Matrix API
- خطمشیها: خطمشیهای Distance Matrix API
- یادداشتهای انتشار: یادداشتهای انتشار Distance Matrix API
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 APIcomputeRouteMatrix(با سرصفحهX-Goog-FieldMask) منتقل شوید. API قدیمی را فقط ازطریق فرم و بهعنوان اقدامی کوتاهمدت فعال کنید. /maps/legacy#LegacyApiNotActivatedMapError را ببینید.