設定路線傳遞點

歐洲經濟區 (EEA) 開發人員

根據預設,中途路線控點用於停靠上車和下車,但您也可以指定中途路線控點僅用於通過。

如果路線包含起點路線控點、中繼路線控點和目的地路線控點,則只會包含一個連接起點和目的地的路線路段,同時通過中繼 (稱為 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
    }
  ]
}