设置途经点

欧洲经济区 (EEA) 开发者

默认情况下，中途经停点用于上下车，但您也可以指定中途经停点仅用于途经。

包含出发地航点、途经中间航点和目的地航点的路线仅包含一个连接出发地和目的地的路线段，同时途经中间（称为 via）航点。

通过以下方式将中间途经点配置为直通途经点：使用 Waypoint (REST) 或 Waypoint (gRPC) 将途经点的 via 属性设置为 true。

在创建路线以响应用户在地图上拖动途经点时，via 属性最为有效。这样一来，用户便可实时查看最终路线的可能外观，并有助于确保航点放置在 Compute Routes 可访问的位置。

以下示例演示了如何将中间途经点标记为直达途经点。

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

获取中间途经点的地点 ID

如果您将起点、目的地或中间途经点的位置指定为地址字符串或 Plus 代码，API 会尝试查找具有相应地点 ID 的最相关位置。结果中的 geocodingResults.intermediates 数组包含与途经点位置对应的地点 ID，以及有关该位置的其他数据。

对于 intermediates 数组的每个元素，请使用 intermediateWaypointRequestIndex 属性来确定请求中的哪个中间途经点与响应中的地点 ID 相对应。

例如：

  • 您在请求中指定了三个中间途经点。其中两个途径点由地址字符串指定，一个由纬度/经度坐标指定。

  • 您可以在响应字段掩码中添加 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'

响应包含 geocodingResults 数组，其中包含起点、目的地和三个途经点中的两个的地点 ID。这些是请求中索引为 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"
      }
    ]
  }
}