TripWaypoint
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Mô tả một điểm dừng trên tuyến đường của xe hoặc một điểm kết thúc trên chuyến đi của xe.
Biểu diễn dưới dạng JSON |
{
"location": {
object (TerminalLocation )
},
"tripId": string,
"waypointType": enum (WaypointType ),
"pathToWaypoint": [
{
object (LatLng )
}
],
"encodedPathToWaypoint": string,
"trafficToWaypoint": {
object (ConsumableTrafficPolyline )
},
"distanceMeters": integer,
"eta": string,
"duration": string
} |
Trường |
location |
object (TerminalLocation )
Vị trí của điểm tham chiếu này.
|
tripId |
string
Chuyến đi được liên kết với điểm tham chiếu này.
|
waypointType |
enum (WaypointType )
Vai trò của điểm tham chiếu này trong chuyến đi, chẳng hạn như đón hoặc trả khách.
|
pathToWaypoint[] |
object (LatLng )
Đường đi từ điểm tham chiếu trước đến điểm tham chiếu hiện tại. Nếu đây là điểm tham chiếu đầu tiên, thì đường dẫn sẽ là từ vị trí hiện tại của xe đến điểm tham chiếu. Trường này chỉ được điền khi có yêu cầu.
|
encodedPathToWaypoint |
string
Đường dẫn được mã hoá từ điểm tham chiếu trước đến điểm tham chiếu hiện tại. Lưu ý: Trường này chỉ dành cho Driver SDK và Consumer SDK. Chưa hỗ trợ tính năng giải mã.
|
trafficToWaypoint |
object (ConsumableTrafficPolyline )
Tình trạng giao thông dọc theo đường đến điểm dừng chân này. Xin lưu ý rằng thông tin về lưu lượng truy cập chỉ dành cho khách hàng sử dụng Giải pháp về Chuyến đi và Giao hàng của Google Maps Platform.
|
distanceMeters |
integer
Khoảng cách đường đi từ điểm tham chiếu trước đến điểm tham chiếu hiện tại. Nếu đây là điểm tham chiếu đầu tiên, thì khoảng cách trên đường đi là từ vị trí hiện tại của xe đến điểm tham chiếu.
|
eta |
string (Timestamp format)
Thời gian đến dự kiến tại điểm tham chiếu này. Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30" .
|
duration |
string (Duration format)
Thời gian di chuyển từ điểm tham chiếu trước đến điểm tham chiếu này. Nếu đây là điểm tham chiếu đầu tiên, thì thời gian di chuyển là từ vị trí hiện tại của xe đến điểm tham chiếu. Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s ". Ví dụ: "3.5s" .
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-31 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\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\"`. |"]]