אתם יכולים לקבל מסלול שמתאים לסוגים שונים של כלי רכב. אם לא מציינים סוג רכב, ברירת המחדל של Routes API היא רכב שמונע בבנזין (DRIVE).
כדי להגדיר את אמצעי התחבורה בבקשת HTTP POST של computeRoutes, מעבירים את השדה travelMode בגוף הבקשה בפורמט JSON באמצעות ערך enum של RouteTravelMode, עם אפשרויות לתחבורה ציבורית, נהיגה, כלי רכב דו-גלגליים, משאיות, הליכה או רכיבה על אופניים.
| סוג הרכב | ערך של RouteTravelMode |
תיאור |
|---|---|---|
| אופניים | BICYCLE |
חישוב מסלול לאופניים ולכלי תחבורה אחרים שמונעים על ידי בני אדם. לרכבים דו-גלגליים ממונעים, ראו רכב דו-גלגלי. |
| Drive | DRIVE |
חישוב מסלול נסיעה.
DRIVE
היא ברירת המחדל אם לא מציינים סוג כלי רכב. |
| תחבורה ציבורית | TRANSIT |
קבלת מסלול לתחבורה ציבורית עם הוראות ניווט באמצעות אפשרויות התחבורה הציבורית שזמינות באזור. אפשרויות התחבורה הציבורית יכולות לכלול אוטובוסים, רכבות תחתיות, רכבות ועוד. מסלול של תחבורה ציבורית כולל בדרך כלל גם הוראות הליכה אל תחנות של תחבורה ציבורית, מהן וביניהן. |
| רכב דו-גלגלי | TWO_WHEELER |
רכב דו-גלגלי מתייחס לכלי רכב ממונעים דו-גלגליים (לדוגמה, אופנועים). מצב הנסיעה ברכב דו-גלגלי שונה ממצב הנסיעה באופניים, שמונעים בכוח אנושי. |
| משאית | TRUCK |
חישוב מסלול שמותאם לרכב גדול על ידי ציון המאפיינים הפיזיים והמגבלות שלו ב-routeModifiers.vehicleInfo.
כדאי להשתמש בסוג כלי רכב זה כדי להימנע מגשרים נמוכים, ממגבלות משקל ומסכנות. |
| הליכה | WALK |
חישוב מסלול הליכה. |
ציון אמצעי התחבורה בבקשה
כדי לציין אמצעי הגעה בבקשה ל-computeRoutes, מגדירים את השדה travelMode בגוף הבקשה בפורמט JSON של HTTP POST וכוללים את הכותרת הנדרשת X-Goog-FieldMask כדי לבחור את שדות התגובה של Route שאתם צריכים. אם אתם עוברים מהגרסה הקודמת של Directions API, השדה travelMode בגוף הבקשה בפורמט JSON של POST מחליף את הפרמטר mode של שאילתת ה-URL בגרסה הקודמת. מידע נוסף זמין במאמר מעבר ל-Routes API.
curl -X POST -d '{ "origin": { "location": { "latLng": { "latitude": 37.419734, "longitude": -122.0827784 } } }, "destination": { "location": { "latLng": { "latitude": 37.417670, "longitude": -122.079595 } } }, "travelMode": "BICYCLE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'