デフォルトでは、中間地点が乗り降り用の停車地に使用されますが、通過のみの中間地点を指定することもできます。
出発地の地点、パススルーの中間地点、目的地の地点を含むルートには、出発地と目的地を結ぶ中間地点(via
)の地点を通過する区間が 1 つだけ含まれます。
ウェイポイント(REST)または ウェイポイント(gRPC)を使用して、ウェイポイントの via
プロパティを true
に設定し、中間ウェイポイントをパススルー ウェイポイントに構成します。
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 つは住所文字列で、もう 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'
レスポンスには、出発地と目的地のプレイス ID と、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" } ] } }