你可以根據不同車輛類型規劃路線。如未指定車輛類型,Routes API 會預設為汽油車 (DRIVE)。
如要在 computeRoutes HTTP POST 要求中設定交通工具,請使用 RouteTravelMode 列舉值,在 JSON 要求主體中傳遞 travelMode 欄位,選項包括大眾運輸、開車、兩輪車輛、卡車、步行或單車。
| 交通工具類型 | RouteTravelMode 值 |
說明 |
|---|---|---|
| 單車 | BICYCLE |
計算自行車和其他人力交通工具的路線。如要瞭解電動二輪車輛,請參閱「二輪車輛」。 |
| 雲端硬碟 | DRIVE |
計算行車路線。
如未指定車輛類型,則預設為 DRIVE。 |
| 大眾運輸 | TRANSIT |
使用該地區提供的大眾運輸選項,取得導航指示的大眾運輸路線。大眾運輸選項包括公車、地鐵和火車等。大眾運輸路線通常也會提供步行前往、離開大眾運輸站點,以及在站點間移動的指示。 |
| 二輪車輛 | TWO_WHEELER |
兩輪車輛是指兩輪機動車輛 (例如摩托車)。兩輪車交通方式與單車交通方式不同,後者是以人力為動力的交通方式。 |
| 卡車 | TRUCK |
在 routeModifiers.vehicleInfo 中指定大型車輛的實體屬性和限制,計算出適合這類車輛的路線。使用這類車輛時,系統會避開低橋、重量限制和危險路段。 |
| 步行 | WALK |
計算步行路線。 |
在要求中指定交通工具
如要在 computeRoutes 要求中指定交通工具,請在 HTTP POST JSON 要求主體中設定 travelMode 欄位,並加入必要的 X-Goog-FieldMask 標頭,選取所需的 Route 回應欄位。如果您要從舊版 Directions API 遷移,POST JSON 要求內文中的 travelMode 欄位會取代舊版 mode 網址查詢參數。詳情請參閱「遷移至 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'