デフォルトでは、中間ウェイポイントは乗車と降車のために停車する場所として使用されますが、中間ウェイポイントを通過するだけの場所として指定することもできます。
出発地のウェイポイント、パススルーの中間ウェイポイント、目的地のウェイポイントを含むルートには、出発地と目的地を接続するルート区間が 1 つだけ含まれます。中間ウェイポイント(via と呼ばれます)を通過します。
Waypoint インターフェースを使用して、ウェイポイントの via プロパティを true に設定することで、中間ウェイポイントをパススルー ウェイポイントとして構成します。
via プロパティは、ユーザーが地図上でウェイポイントをドラッグしたことに応じてルートを作成する場合に最も効果的です。これにより、ユーザーは最終的なルートがリアルタイムでどのように表示されるかを確認できます。また、ウェイポイントが Routes ライブラリにアクセス可能な場所に配置されていることを確認できます。
リクエスト例
次のリクエストの例は、中間ウェイポイントをパススルー ウェイポイントとしてマークする方法を示しています。
const routeRequestWithVia = { origin: '100 Moffett Blvd, Mountain View, CA 94043', destination: '1199 9th Ave, San Francisco, CA 94122', travelMode: 'DRIVING', intermediates: [ {location: 'Half Moon Bay, CA', via: true} // Set the via property to true ], fields: ['path', 'legs'], }; // Make the request. const {routes, fallbackInfo, geocodingResults} = await Route.computeRoutes(routeRequestWithIntermediates);
中間ウェイポイントのプレイス ID にアクセスする
出発地、目的地、中間地点の場所を住所文字列または Plus Code で指定すると、Routes ライブラリは、対応するプレイス ID を持つ最も関連性の高い場所を検索します。結果の geocodingResults.intermediates 配列には、ウェイポイントの場所に対応するプレイス ID と、その場所に関する追加データが含まれます。
ジオコーディング結果のレスポンスの例
{ "origin": { "geocoderStatus": "OK", "types": [ "premise", "street_address" ], "partialMatch": false, "placeId": "ChIJb5NgcTa3j4ARrfF4Oc_f6q8", "intermediateWaypointRequestIndex": null }, "destination": { "geocoderStatus": "OK", "types": [ "premise", "street_address" ], "partialMatch": false, "placeId": "ChIJAbIPLl2HhYARQ0SSdDFxU-s", "intermediateWaypointRequestIndex": null }, "intermediates": [ { "geocoderStatus": "OK", "types": [ "locality", "political" ], "partialMatch": false, "placeId": "ChIJC8sZCqULj4ARVJvnNcic_V4", "intermediateWaypointRequestIndex": 0 } ] }