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 地圖平台 Rides and Deliveries Solution 客戶。
|
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)
從上一個中途點到這個中途點的旅行時間。如果是第一個中途點,則為車輛目前位置到中途點的行車時間。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「s 」結尾,例如:"3.5s" 。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-31 (世界標準時間)。
[null,null,["上次更新時間: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\"`. |"]]