设置沿途停留点

欧洲经济区 (EEA) 开发者

您可以通过以下两种方式之一在路线上设置经停点,例如接送点:

  • 添加中途经停点:这是默认选项。在 intermediates 数组中添加出发地和目的地之间的中途经停点。路由引擎会将途经点贴靠到最近的可导航道路,并将路线划分为由该经停点连接的 RouteLeg 个路段。
  • 指定 vehicleStopover:如果您希望路线规划引擎执行额外分析,以避开不适合停车的路段(例如高速公路、隧道或天桥),请在途经点上设置 vehicleStopover: true

添加中途经停点

如需在路线中设置经停点,请在请求的 intermediates 数组中添加中间途经点。

添加中途经停点会产生以下影响:

  • 路线分为 RouteLeg 个路段:每个路段都将一个经停点与下一个经停点相连。
  • 坐标贴合到道路:路线规划引擎会将您的纬度和经度坐标(可能位于屋顶或院子里)贴合到最近的可导航路段。

对于许多地面道路,贴靠到最近的道路可提供实用的停车位置。不过,贴合功能无法确定相应路段是否适合靠边停车,例如最近的道路是高速公路还是隧道。

示例:添加中途航点

以下示例演示了如何通过在 computeRoutes POST 请求中添加中间途经点来设置路线中的停靠点:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    }
  ],
  "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' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

如需详细了解中途经停点和路线段,请参阅设置中途经停点

指定用于确定上车和下车适宜性的 vehicleStopover

虽然标准中间途经点会贴靠到最近的道路,但该道路并不总是适合车辆停靠。如果您希望路线规划引擎执行额外的分析来评估道路是否适合接客或送客,请在途经点上设置 vehicleStopover: true

当您设置 vehicleStopover: true 时,路线引擎会评估候选路段,并尝试避开不适合停车的道路,例如高速公路、隧道和天桥。

例如,假设某个位置的地面道路直接位于隧道内的高速公路之上: * 标准中间途经点:如果几何距离更近,则会贴靠到下方的高速公路或隧道。 * 车辆经停点:执行额外分析以绕过高速公路和隧道,并将经停点贴靠到适合停车的地面道路上。

示例:在途经点上指定 vehicleStopover

以下示例演示了如何在完整的 POST 请求中对中间途经点设置 vehicleStopover: true

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      },
      "vehicleStopover": true
    }
  ],
  "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' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

如需详细了解航点类型和选项,请参阅航点类型和选项