你可以取得不同類型車輛的路線矩陣。如要在 computeRouteMatrix HTTP POST 要求中設定交通工具,請使用 RouteTravelMode 列舉值,在 JSON 要求主體中傳遞 travelMode 欄位。如未指定 travelMode 值,Routes API 會使用預設值 DRIVE。
您可以選擇開車、兩輪車、大眾運輸、卡車或步行。路線矩陣不支援單車路線 (BICYCLE)。
| 交通工具類型 | RouteTravelMode 值 |
說明 |
|---|---|---|
| 雲端硬碟 | DRIVE |
計算行車路線矩陣。
如未指定車輛類型,則預設為 DRIVE。 |
| 二輪車輛 | TWO_WHEELER |
指定機車路線矩陣的方式與指定路線相同,都是使用 travelMode 欄位。 |
| 大眾運輸 | TRANSIT |
取得大眾運輸路線矩陣,其中包含該區域可用的大眾運輸選項。大眾運輸選項包括公車、地鐵和火車等。 |
| 卡車 | TRUCK |
使用大型車輛路線規劃功能,計算出發地和目的地矩陣的行程時間和距離。在 origins[].routeModifiers.vehicleInfo 中指定車輛的實體屬性,即可取得考量重量、高度和危險物品限制的準確估算結果。 |
| 步行 | WALK |
計算步行路線矩陣。 |
在要求中指定交通工具
如要在 computeRouteMatrix 要求中指定交通工具,請在 HTTP POST JSON 要求主體中設定 travelMode 欄位,並加入必要的 X-Goog-FieldMask 標頭,選取所需的 RouteMatrixElement 回應欄位。如果您是從舊版 Distance Matrix API 遷移,POST JSON 要求主體中的 travelMode 欄位會取代舊版 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'