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

欧州経済領域（EEA）のデベロッパー

デフォルトでは、中間ウェイポイントは乗車と降車の停車に使用されますが、中間ウェイポイントを通過のみに使用するように指定することもできます。

出発地点、通過地点、目的地点を含むルートには、出発地点と目的地点を結び、通過地点（via と呼ばれます）を経由するルート区間が 1 つだけ含まれます。

Waypoint（REST）または Waypoint（gRPC）を使用して、ウェイポイントの via プロパティを true に設定し、中間ウェイポイントをパススルー ウェイポイントとして構成します。

via プロパティは、ユーザーが地図上の経由地をドラッグしたときに経路を作成する場合に最も効果的です。これにより、ユーザーは最終的なルートがリアルタイムでどのように表示されるかを確認し、Compute Routes でアクセス可能な場所に経由地が配置されるようにすることができます。

次の例は、中間経由地を通過経由地としてマークする方法を示しています。

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

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

出発地、目的地、中間地点の位置を住所文字列またはプラスコードとして指定すると、API は対応するプレイス ID を持つ最も関連性の高い位置を検索します。結果の geocodingResults.intermediates 配列には、経由地の位置に対応するプレイス ID と、その位置に関する追加データが含まれます。

intermediates 配列の各要素で、intermediateWaypointRequestIndex プロパティを使用して、リクエストの中間経由地がレスポンスのプレイス ID に対応するかどうかを判断します。

次に例を示します。

  • リクエストで 3 つの中間ウェイポイントを指定します。これらの経由地のうち 2 つは住所文字列で指定され、1 つは緯度/経度の座標で指定されます。

  • レスポンス フィールド マスクに 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'

レスポンスには、出発地、目的地、3 つのウェイポイントのうち 2 つの場所 ID を含む geocodingResults 配列が含まれます。これらは、リクエストのインデックス 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"
      }
    ]
  }
}