別の経路をリクエストする

デフォルトでは、Routes API はデフォルト ルートを返します。 出発地から目的地までの最速ルートを 考えてみますリクエスト時 代替ルートの場合、API は最大 3 つのルートと、デフォルトの ありますユーザーはその後、要件に最適なルートを選択できます。

代替ルートをリクエストする際の考慮事項

代替ルートをリクエストするには、次の点に注意してください。

  • 代替ルートをリクエストできるのは、中間ルートがないルートのみです ありますルートでルートが指定されている場合に代替ルートをリクエストする 中間ウェイポイントではエラーになりません代替手法は 返されます。

  • レスポンスには、最大 3 つの代替ルートが含まれます。ただし、 代替ルートが利用できない場合があるため、レスポンスには 使用します。

  • 代替値の計算には追加の処理が必要となるため、 代替ルートをリクエストすると、サービスの応答時間が できます。

代替ルートのリクエストの例

代替ルートをリクエストするには、computeAlternativeRoutestrue に設定します。「 次の例は、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'

この例では、レスポンスに特定のフィールドのみが含まれるように、フィールド マスクを指定しています。 各ルートの durationdistanceMeters,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"
      ]
    }
   ]
}