デフォルトでは、Routes API はデフォルト ルートを返します。 出発地から目的地までの最速ルートを 考えてみますリクエスト時 代替ルートの場合、API は最大 3 つのルートと、デフォルトの ありますユーザーはその後、要件に最適なルートを選択できます。
代替ルートをリクエストする際の考慮事項
代替ルートをリクエストするには、次の点に注意してください。
代替ルートをリクエストできるのは、中間ルートがないルートのみです ありますルートでルートが指定されている場合に代替ルートをリクエストする 中間ウェイポイントではエラーになりません代替手法は 返されます。
レスポンスには、最大 3 つの代替ルートが含まれます。ただし、 代替ルートが利用できない場合があるため、レスポンスには 使用します。
代替値の計算には追加の処理が必要となるため、 代替ルートをリクエストすると、サービスの応答時間が できます。
代替ルートのリクエストの例
代替ルートをリクエストするには、computeAlternativeRoutes
を true
に設定します。「
次の例は、Cloud Storage バケットで代替ルートをリクエストする方法を示しています。
computeRoutes
メソッド(REST)リクエスト。
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude":42.340173523716736, "longitude":-71.05997968330408 } } }, "destination":{ "location":{ "latLng":{ "latitude":42.075698891472804, "longitude": -72.59806562080408 } } }, "travelMode": "DRIVE", "routingPreference":"TRAFFIC_AWARE", "computeAlternativeRoutes": true }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
この例では、レスポンスに特定のフィールドのみが含まれるように、フィールド マスクを指定しています。
各ルートの duration
、distanceMeters,
、routeLabels
プロパティ。お客様の
お客様はその情報を基に、利用するルートを選択できます。詳細情報
返す情報を選択するをご覧ください。
代替ルートのレスポンスの例
レスポンスでは、routeLabels
配列プロパティを使用してリーチを特定します。
route:
デフォルト ルートの場合、
routeLabels
プロパティには次の値が含まれます。DEFAULT_ROUTE
。代替ルートの場合、
routeLabels
プロパティには次の値が含まれます。DEFAULT_ROUTE_ALTERNATE
。
この例のレスポンスには、デフォルト ルートと 2 つの代替ルートが含まれています。
routes:duration
プロパティと distanceMeters
プロパティの値は、
経路によって異なります。
{ "routes": [ { "distanceMeters": 150322, "duration": "5309s", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 157614, "duration": "6879s", "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] }, { "distanceMeters": 189311, "duration": "7376s", "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] } ] }
レスポンスにポリラインを含める
ユーザーがルートを選択しやすくなるように、 ポリライン。その後、 地図上に各ポリラインを表示します。
ポリラインを追加するには、フィールド マスクに routes.polyline
を含めます。
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'
レスポンスには各ルートのポリラインが含まれます。
{ "routes": [ { "distanceMeters": 150322, "duration": "5309s", "polyline": { "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 157614, "duration": "6879s", "polyline": { "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] }, { "distanceMeters": 189311, "duration": "7376s", "polyline": { "encodedPolyline": "FVLL|Af@HPAV…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] } ] }