このページは Cloud Translation API によって翻訳されました。

通過するルートの地点を設定する

デフォルトでは、乗車地点と停車地点の停車地に中間地点が使用されます。中間の地点を 1 地点あたり渡します。

出発地のウェイポイント（パススルーの中間地点）を含むルート目的地のウェイポイントには、そのルートの区間が 1 つだけは、中間地点を通過しながら、出発地と目的地を接続します。（via）ウェイポイント。

通過地点となるように中間地点を設定します。次のいずれかを使用して、地点の via プロパティを true に設定します。ウェイポイント（REST）または Waypoint（gRPC）。

via プロパティは、レスポンスに応じてルートを作成する場合に、最も効果的です。ユーザーが地図上のウェイポイントをドラッグします。そうすることで、ユーザーはリアルタイムで最終ルートを確認でき、Compute Routes がアクセス可能な地点に確実にウェイポイントを配置するのに役立ちます。

次の例は、中間地点をあります。

{
  "location": {
    "latLng": {
      "latitude":37.419734,
      "longitude":-122.0827784
    }
  },
  "via": true
}

中間ウェイポイントの場所 ID にアクセスする

出発地、目的地、中間地点の場所を指定する場合 Plus Code として検索した場合、API は最も関連性が高い位置情報で、対応するプレイス ID を持つ必要があります。「 geocodingResults.intermediates 配列内の場所に対応するプレイス ID が結果に含まれる場所に関する追加データとともに表示されます。

intermediates 配列の要素ごとに、次のコマンドを使用します。 intermediateWaypointRequestIndex プロパティを使用して、レスポンスのプレイス ID に対応している必要があります。

例:

リクエストには 3 つの中間地点を指定します。そのうちの 2 つ地点は住所文字列で指定され、もう一つは緯度/経度で指定指定します。
レスポンスフィールドマスクに geocodingResults を含めて、以下を指定します。結果で geocodingResults 配列を返します。

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "intermediates": [
    {
      "address": "450 Serra Mall, Stanford, CA 94305, USA"
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    },
    {
      "address": "1836 El Camino Real, Redwood City, CA 94063"
    }
  ],
  "travelMode": "DRIVE",
}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs,geocodingResults'
'https://routes.googleapis.com/directions/v2:computeRoutes'

レスポンスには、次の場所のプレイス ID を含む geocodingResults 配列が含まれます。 3 つのウェイポイントのうちの 2 つこれらはインデックス 0 と 2 にあります。北極のインデックス 1 にあるウェイポイントは緯度と経度の座標を使用して指定された場合、レスポンスの geocodingResults 配列から省略されます。

{
  "routes": [{...}],
  "geocodingResults": {
    "origin": {
      "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJj38IfwK6j4ARNcyPDnEGa9g"
    },
    "destination": {
     "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJI7ES6tl_j4ARVpDZoXbWAiY"
    },
    "intermediates": [
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 0,
        "type": [
            "street_address"
        ],
        "placeId": "ChIJvdLMGyq7j4ARScE5tWX_C0Y"
      },
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 2,
        "type": [
          "premise"
        ],
        "placeId": "ChIJkTc0GKajj4AR9UMsOSHwGD0"
      }
    ]
  }
}