میتوانید ماتریس مسیر را برای انواع مختلف وسایل نقلیه دریافت کنید. برای تنظیم حالت
سفر در
computeRouteMatrix
درخواست HTTP POST،
travelMode
فیلد را در بدنه درخواست JSON بااستفاده از
RouteTravelMode
مقدار شمارشی ارسال کنید. اگر مقدار
travelMode
را مشخص نکنید، Routes API از مقدار پیشفرض
DRIVE
استفاده میکند.
میتوانید رانندگی، وسایل نقلیه دوچرخ، حملونقل عمومی، کامیون، یا پیادهروی را انتخاب کنید.
دوچرخهسواری
(BICYCLE)
برای ماتریسهای مسیر پشتیبانی نمیشود.
| نوع خودرو | مقدار RouteTravelMode |
شرح |
|---|---|---|
| Drive | DRIVE |
محاسبه ماتریس مسیر رانندگی.
DRIVE
اگر نوع خودرو را مشخص نکنید، این گزینه پیشفرض است. |
| موتورسیکلت | TWO_WHEELER |
ماتریس مسیر را برای وسیله نقلیه موتوری دوچرخ به همان روشی که برای مسیر مشخص میکنید، بااستفاده از فیلد travelMode مشخص میکنید. |
| حملونقل عمومی | TRANSIT |
ماتریس مسیر حملونقل عمومی را دریافت کنید که از گزینههای حملونقل عمومی دردسترس در منطقه استفاده میکند. گزینههای حملونقل عمومی میتواند شامل اتوبوس، مترو، قطار، و غیره باشد. |
| کامیون | TRUCK |
محاسبه زمان و مسافت سفر برای ماتریسی از مبدأها و مقصدها بااستفاده از مسیریابی خودروهای بزرگ. ویژگیهای فیزیکی
خودروهایتان را در
origins[].routeModifiers.vehicleInfo
مشخص کنید تا برآوردهای دقیقی دریافت کنید که محدودیتهای وزن، ارتفاع، و مواد خطرناک را درنظر میگیرد. |
| پیادهروی | WALK |
ماتریس مسیر پیادهروی را محاسبه کنید. |
مشخص کردن حالت سفر در درخواست
برای مشخص کردن حالت سفر در درخواست
computeRouteMatrix
، فیلد
travelMode
را در بدنه درخواست JSON HTTP POST تنظیم کنید و سرصفحه
X-Goog-FieldMask الزامی را برای انتخاب فیلدهای پاسخ
RouteMatrixElement
موردنیازتان اضافه کنید. اگر از Distance Matrix API قدیمی مهاجرت میکنید، فیلد travelMode در بدنه درخواست JSON POST جایگزین پارامتر پُرسمان نشانی وب قدیمی mode میشود. برای اطلاعات بیشتر،
انتقال به Routes API را ببینید.
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } } ], "travelMode": "WALK" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'