TripWaypoint
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Descrive un punto di sosta sul percorso di un veicolo o un punto di arrivo del viaggio di un veicolo.
| Rappresentazione JSON |
{
"location": {
object (TerminalLocation)
},
"tripId": string,
"waypointType": enum (WaypointType),
"pathToWaypoint": [
{
object (LatLng)
}
],
"encodedPathToWaypoint": string,
"trafficToWaypoint": {
object (ConsumableTrafficPolyline)
},
"distanceMeters": integer,
"eta": string,
"duration": string
} |
| Campi |
location |
object (TerminalLocation)
La posizione di questo waypoint.
|
tripId |
string
Il viaggio associato a questo waypoint.
|
waypointType |
enum (WaypointType)
Il ruolo che svolge questo waypoint nel viaggio, ad esempio ritiro o consegna.
|
pathToWaypoint[] |
object (LatLng)
Il percorso dal waypoint precedente a quello attuale. Se si tratta del primo waypoint, il percorso va dalla posizione attuale del veicolo al waypoint. Questo campo viene compilato solo su richiesta.
|
encodedPathToWaypoint |
string
Il percorso codificato dal waypoint precedente a quello attuale. Nota: questo campo è destinato esclusivamente all'uso da parte di Driver SDK e Consumer SDK. La decodifica non è ancora supportata.
|
trafficToWaypoint |
object (ConsumableTrafficPolyline)
Le condizioni del traffico lungo il percorso fino a questo waypoint. Tieni presente che il traffico è disponibile solo per i clienti della soluzione Rides and Deliveries di Google Maps Platform.
|
distanceMeters |
integer
La distanza del percorso dal waypoint precedente a quello attuale. Se questo è il primo waypoint, la distanza del percorso è dalla posizione attuale del veicolo al waypoint.
|
eta |
string (Timestamp format)
L'orario di arrivo stimato a questo waypoint. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
|
duration |
string (Duration format)
Il tempo di viaggio dal waypoint precedente a questo waypoint. Se si tratta del primo waypoint, il tempo di percorrenza è dalla posizione attuale del veicolo al waypoint. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 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\"`. |"]]
