אפשר לקבל מטריצת מסלולים לסוגים שונים של כלי רכב. כדי להגדיר את אמצעי התחבורה בבקשת HTTP POST ב-computeRouteMatrix, מעבירים את השדה travelMode בגוף הבקשה בפורמט JSON באמצעות ערך enum של RouteTravelMode. אם לא מציינים ערך של travelMode, Routes API משתמש בערך ברירת המחדל DRIVE.
אתם יכולים לבחור נהיגה, רכב דו-גלגלי, תחבורה ציבורית, משאיות או הליכה.
רכיבה על אופניים (BICYCLE) לא נתמכת במטריצות של מסלולים.
| סוג הרכב | ערך של RouteTravelMode |
תיאור |
|---|---|---|
| Drive | DRIVE |
חישוב מטריצה של מסלולי נסיעה.
DRIVE
הוא ברירת המחדל אם לא מציינים סוג כלי רכב. |
| רכב דו-גלגלי | TWO_WHEELER |
מגדירים מטריצת מסלולים לרכב ממונע עם שני גלגלים באותה דרך שבה מגדירים אותה למסלול, באמצעות השדה travelMode. |
| תחבורה ציבורית | TRANSIT |
קבלת מטריצת מסלולי תחבורה ציבורית שמתבססת על אפשרויות התחבורה הציבורית שזמינות באזור. אפשרויות התחבורה הציבורית יכולות לכלול אוטובוסים, רכבות תחתיות, רכבות ועוד. |
| משאית | TRUCK |
חישוב זמני הגעה ומרחקים למטריצה של נקודות מוצא ויעדים באמצעות ניתוב של כלי רכב גדולים. כדי לקבל אומדנים מדויקים שמביאים בחשבון את המשקל, הגובה וההגבלות על חומרים מסוכנים, צריך לציין את המאפיינים הפיזיים של הרכבים ב-origins[].routeModifiers.vehicleInfo. |
| הליכה | WALK |
חישוב מטריצת מסלול הליכה. |
ציון אמצעי התחבורה בבקשה
כדי לציין אמצעי תחבורה בבקשת computeRouteMatrix, צריך להגדיר את השדה travelMode בגוף הבקשה ב-JSON של HTTP ולכלול את כותרת X-Goog-FieldMask הנדרשת כדי לבחור את שדות התגובה RouteMatrixElement שאתם צריכים.POST אם אתם עוברים מהגרסה הקודמת של Distance Matrix API, השדה travelMode בגוף הבקשה בפורמט JSON של POST מחליף את הפרמטר mode של שאילתת ה-URL בגרסה הקודמת. מידע נוסף זמין במאמר מעבר ל-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'