Waypoint
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Incapsula una tappa. I waypoint contrassegnano sia l'inizio che la fine di un percorso e includono fermate intermedie lungo il percorso.
| Rappresentazione 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
// End of list of possible types for union field location_type.
} |
| Campi |
via |
boolean
Contrassegna questa tappa come tappa anziché come punto di sosta. Per ogni tappa non via nella richiesta, la risposta aggiunge una voce all'array legslegs, ma consentono di seguire il percorso attraverso la tappa. Puoi impostare questo valore solo per le tappe intermedie. Se imposti questo campo sulle tappe del terminale, la richiesta non va a buon fine. Se il criterio ComputeRoutesRequest.optimize_waypoint_order viene impostato su true, il campo non può essere impostato su true. altrimenti la richiesta non va a buon fine.
|
vehicleStopover |
boolean
Indica che la tappa è destinata ai veicoli in cui devono fermarsi, con l'intenzione di salire o scendere dal mezzo. Se imposti questo valore, il percorso calcolato non includerà tappe non via su strade non adatte alla partenza e alla discesa. Questa opzione funziona solo per le modalità di viaggio DRIVE e TWO_WHEELER e quando locationType è Location
|
sideOfRoad |
boolean
Indica che la posizione di questa tappa deve avere una preferenza che il veicolo si fermi in un determinato lato della strada. Quando imposti questo valore, il percorso attraversa la posizione in modo che il veicolo possa fermarsi sul lato della strada inclinato rispetto alla posizione rispetto al centro della strada. Questa opzione funziona solo per DRIVE e TWO_WHEELER RouteTravelMode
|
Campo unione location_type. Diversi modi per rappresentare un luogo. location_type può essere solo uno dei seguenti: |
location |
object (Location)
Un punto specificato utilizzando le coordinate geografiche, inclusa un'intestazione facoltativa.
|
placeId |
string
L'ID luogo del PDI associato alla tappa.
|
address |
string
Indirizzo leggibile o un plus code. Per maggiori dettagli, vedi https://plus.codes.
|
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 define the start, end, and intermediate points of a route.\u003c/p\u003e\n"],["\u003cp\u003eWaypoints can be specified using geographic coordinates, Place IDs, or addresses.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003evia\u003c/code\u003e field allows a waypoint to be a pass-through point without stopping.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003evehicleStopover\u003c/code\u003e is used for pickup/drop-off optimization, while \u003ccode\u003esideOfRoad\u003c/code\u003e indicates preferred stopping side.\u003c/p\u003e\n"]]],["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"],null,["# Waypoint\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nEncapsulates a waypoint. Waypoints mark both the beginning and end of a route, and include intermediate stops along the route.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"via\": boolean, \"vehicleStopover\": boolean, \"sideOfRoad\": boolean, // Union field `location_type` can be only one of the following: \"location\": { object (/maps/documentation/routes/reference/rest/v2/Location) }, \"placeId\": string, \"address\": string // End of list of possible types for union field `location_type`. } ``` |\n\n| Fields ||\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `via` | `boolean` Marks this waypoint as a milestone rather a stopping point. For each non-via waypoint in the request, the response appends an entry to the [`legs`](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#Route.FIELDS.legs) array to provide the details for stopovers on that leg of the trip. Set this value to true when you want the route to pass through this waypoint without stopping over. Via waypoints don't cause an entry to be added to the `legs` array, but they do route the journey through the waypoint. You can only set this value on waypoints that are intermediates. The request fails if you set this field on terminal waypoints. If `ComputeRoutesRequest.optimize_waypoint_order` is set to true then this field cannot be set to true; otherwise, the request fails. |\n| `vehicleStopover` | `boolean` Indicates that the waypoint is meant for vehicles to stop at, where the intention is to either pickup or drop-off. When you set this value, the calculated route won't include non-`via` waypoints on roads that are unsuitable for pickup and drop-off. This option works only for `DRIVE` and `TWO_WHEELER` travel modes, and when the `locationType` is [`Location`](/maps/documentation/routes/reference/rest/v2/Location). |\n| `sideOfRoad` | `boolean` Indicates that the location of this waypoint is meant to have a preference for the vehicle to stop at a particular side of road. When you set this value, the route will pass through the location so that the vehicle can stop at the side of road that the location is biased towards from the center of the road. This option works only for `DRIVE` and `TWO_WHEELER` [`RouteTravelMode`](/maps/documentation/routes/reference/rest/v2/RouteTravelMode). |\n| Union field `location_type`. Different ways to represent a location. `location_type` can be only one of the following: ||\n| `location` | `object (`[Location](/maps/documentation/routes/reference/rest/v2/Location)`)` A point specified using geographic coordinates, including an optional heading. |\n| `placeId` | `string` The POI Place ID associated with the waypoint. |\n| `address` | `string` Human readable address or a plus code. See \u003chttps://plus.codes\u003e for details. |"]]
