TripWaypoint
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
JSON 表示法 |
{
"location": {
object (TerminalLocation )
},
"tripId": string,
"waypointType": enum (WaypointType ),
"pathToWaypoint": [
{
object (LatLng )
}
],
"encodedPathToWaypoint": string,
"trafficToWaypoint": {
object (ConsumableTrafficPolyline )
},
"distanceMeters": integer,
"eta": string,
"duration": string
} |
字段 |
location |
object (TerminalLocation )
相应途经点的位置。
|
tripId |
string
与此途经点关联的行程。
|
waypointType |
enum (WaypointType )
此途经点在此行程中扮演的角色,例如上车点或下车点。
|
pathToWaypoint[] |
object (LatLng )
从上一个途经点到当前途经点的路径。如果这是第一个途经点,则路径是从车辆的当前位置到该途经点。仅在请求时填充此字段。
|
encodedPathToWaypoint |
string
从上一个途经点到当前途经点的编码路径。 注意:此字段仅供 Driver SDK 和 Consumer SDK 使用。尚不支持解码。
|
trafficToWaypoint |
object (ConsumableTrafficPolyline )
前往此途经点的路径上的路况。请注意,流量信息仅适用于 Google 地图平台出行和配送解决方案客户。
|
distanceMeters |
integer
从上一个途径点到当前途径点的路径距离。如果这是第一个途经点,则路径距离是指从车辆当前位置到途经点的距离。
|
eta |
string (Timestamp format)
到达此途经点的预计时间。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z" 、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30" 。
|
duration |
string (Duration format)
从上一个途经点到此途经点的旅行时间。如果这是第一个途经点,则行驶时间是从车辆当前位置到该途经点的时间。 该时长以秒为单位,最多包含九个小数位,以“s ”结尾。示例:"3.5s" 。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-31。
[null,null,["最后更新时间 (UTC):2025-08-31。"],[[["\u003cp\u003eWaypoints represent stopping points or ending points on a vehicle's route or trip.\u003c/p\u003e\n"],["\u003cp\u003eEach waypoint includes information like location, trip ID, type (pickup, dropoff), path, and estimated arrival time.\u003c/p\u003e\n"],["\u003cp\u003eWaypoints can optionally include details about the path to the waypoint, traffic conditions, and distance.\u003c/p\u003e\n"],["\u003cp\u003eThe ETA and duration fields provide estimates for arrival time and travel time to the waypoint.\u003c/p\u003e\n"]]],["This data represents a waypoint, a stopping or ending point in a vehicle's trip. Key information includes the `location`, the associated `tripId`, and the `waypointType` (e.g., pickup, dropoff). It also provides path details like `pathToWaypoint`, `encodedPathToWaypoint`, and `trafficToWaypoint`, alongside metrics such as `distanceMeters`, `eta` (estimated time of arrival), and `duration` (travel time). Some data, like path details and time-related metrics, are undefined for the initial waypoint.\n"],null,["# TripWaypoint\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nDescribes a stopping point on a vehicle's route or an ending point on a vehicle's trip.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"location\": { object (/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/TerminalLocation) }, \"tripId\": string, \"waypointType\": enum (/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/WaypointType), \"pathToWaypoint\": [ { object (/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/LatLng) } ], \"encodedPathToWaypoint\": string, \"trafficToWaypoint\": { object (/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/ConsumableTrafficPolyline) }, \"distanceMeters\": integer, \"eta\": string, \"duration\": string } ``` |\n\n| Fields ||\n|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `location` | `object (`[TerminalLocation](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/TerminalLocation)`)` The location of this waypoint. |\n| `tripId` | `string` The trip associated with this waypoint. |\n| `waypointType` | `enum (`[WaypointType](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/WaypointType)`)` The role this waypoint plays in this trip, such as pickup or dropoff. |\n| `pathToWaypoint[]` | `object (`[LatLng](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/LatLng)`)` The path from the previous waypoint to the current waypoint. If this is the first waypoint, the path is from the vehicle's current location to the waypoint. This field is only populated when requested. |\n| `encodedPathToWaypoint` | `string` The encoded path from the previous waypoint to the current waypoint. \u003cbr /\u003e Note: This field is intended only for use by the Driver SDK and Consumer SDK. Decoding is not yet supported. |\n| `trafficToWaypoint` | `object (`[ConsumableTrafficPolyline](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/ConsumableTrafficPolyline)`)` The traffic conditions along the path to this waypoint. Note that traffic is only available for Google Map Platform Rides and Deliveries Solution customers. |\n| `distanceMeters` | `integer` The path distance from the previous waypoint to the current waypoint. If this is the first waypoint, the path distance is from the vehicle's current location to the waypoint. |\n| `eta` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` The estimated time of arrival at this waypoint. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `duration` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` The travel time from previous waypoint to this waypoint. If this is the first waypoint, the travel time is from the vehicle's current location to the waypoint. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |"]]