根據預設,中途路線控點用於停靠上車和下車,但您也可以指定中途路線控點僅用於通過。
如果路線包含起點路線控點、中繼路線控點和目的地路線控點,則只會包含一個連接起點和目的地的路線路段,同時通過中繼 (稱為 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 } ] }