Waypoint
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
封装了途经点。航点标记路线的起点和终点,并包含路线上的中途停留点。
| JSON 表示法 |
{
"via": boolean,
"vehicleStopover": boolean,
"sideOfRoad": boolean,
// Union field location_type can be only one of the following:
"location": {
object (Location)
},
"placeId": string,
"address": string,
"navigationPointToken": string
// End of list of possible types for union field location_type.
} |
| 字段 |
via |
boolean
将此途经点标记为里程碑,而非停靠点。对于请求中的每个非途经点,响应都会向 legs 数组附加一个条目,以提供相应行程段的经停点详情。如果您希望路线经过此途经点而不在此停留,请将此值设置为 true。途经航点不会导致向 legs 数组添加条目,但它们确实会使行程途经该航点。您只能在中间途经点上设置此值。如果您在终端航点上设置此字段,请求会失败。如果 ComputeRoutesRequest.optimize_waypoint_order 设置为 true,则此字段不能设置为 true;否则,请求会失败。
|
vehicleStopover |
boolean
表示此途经点供车辆停靠,目的是接客或送客。设置此值后,计算出的路线不会包含不适合接客和送客的道路上的非 via 途经点。此选项仅适用于 DRIVE 和 TWO_WHEELER 出行模式,且 locationType 为 Location。
|
sideOfRoad |
boolean
表示此航点的位置旨在让车辆优先停靠在道路的特定一侧。设置此值后,路线将经过相应位置,以便车辆停靠在道路中心偏向该位置的一侧。此选项仅适用于 DRIVE 和 TWO_WHEELER RouteTravelMode。
|
联合字段 location_type。表示位置的不同方式。location_type 只能是下列其中一项: |
location |
object (Location)
使用地理坐标指定的点,包括可选的航向。
|
placeId |
string
与航点关联的地图注点地点 ID。
|
address |
string
人类可读的地址或 Plus Code。如需了解详情,请参阅 https://plus.codes。
|
navigationPointToken |
string
用于标识 NavigationPoint 的令牌,通过 Geocoding API 的 SearchDestinations 方法获取。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2026-03-05。
[null,null,["最后更新时间 (UTC):2026-03-05。"],[],["Waypoints, marking route start, end, and intermediate stops, are defined using a JSON format. Key properties include `via` (boolean) for non-stopping waypoints, `vehicleStopover` (boolean) for pickup/drop-off locations, and `sideOfRoad` (boolean) for preferred stopping side. A waypoint's `location_type` can be specified via geographic coordinates (`location`), a place ID (`placeId`), or a human-readable address (`address`). `via` cannot be true for terminal waypoints or if `optimize_waypoint_order` is true.\n"]]