میتوانید ماتریس مسیر را برای انواع مختلف وسایل نقلیه دریافت کنید. برای تنظیم حالت سفر در درخواست اچتیتیپی computeRouteMatrixPOST، فیلد travelMode را در بدنه درخواست JSON بااستفاده از مقدار شمارشی RouteTravelMode ارسال کنید. اگر
travelMode
مقدار را مشخص نکنید، «میانای برنامهسازی کاربردی مسیرها» از پیشفرض
DRIVE استفاده میکند.
میتوانید رانندگی، وسایل نقلیه دوچرخ، حملونقل عمومی، کامیون، یا پیادهروی را انتخاب کنید.
دوچرخهسواری
(BICYCLE)
برای ماتریسهای مسیر پشتیبانی نمیشود.
| نوع خودرو | مقدار RouteTravelMode |
شرح |
|---|---|---|
| Drive | DRIVE |
محاسبه ماتریس مسیر رانندگی.
DRIVE
اگر نوع خودرو را مشخص نکنید، پیشفرض است. |
| وسیله نقلیه دوچرخ | TWO_WHEELER |
ماتریس مسیر را برای وسیله نقلیه موتوری دوچرخ به همان روشی که برای مسیر مشخص میکنید، بااستفاده از فیلد travelMode مشخص میکنید. |
| حملونقل عمومی | TRANSIT |
ماتریس مسیر حملونقل عمومی را که از گزینههای حملونقل عمومی دردسترس در منطقه استفاده میکند دریافت کنید. گزینههای حملونقل عمومی میتواند شامل اتوبوس، مترو، قطار، و غیره باشد. |
| کامیون | TRUCK |
محاسبه زمان و فاصله سفر برای ماتریس مبدأها و مقصدها بااستفاده از مسیریابی خودروهای بزرگ. ویژگیهای فیزیکی
خودروهایتان را در
origins[].routeModifiers.vehicleInfo
مشخص کنید تا برآوردهای دقیقی دریافت کنید که محدودیتهای مربوط به وزن، ارتفاع، و مواد
خطرناک را درنظر میگیرد. |
| پیادهروی | WALK |
ماتریس مسیر پیادهروی را محاسبه کنید. |
مشخص کردن حالت سفر در درخواست
برای مشخص کردن حالت سفر در
computeRouteMatrix
درخواست، فیلد
travelMode
را در بدنه درخواست JSON POST HTTP تنظیم کنید و سرصفحه
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'