Waypoint
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Encapsule un point de cheminement. Les points de cheminement marquent le début et la fin de l'itinéraire, et incluent les arrêts intermédiaires sur l'itinéraire.
Représentation 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 .
} |
Champs |
via |
boolean
Marque ce point de cheminement comme un jalon plutôt que comme un point d'arrêt. Pour chaque point de cheminement non via de la requête, la réponse ajoute une entrée au tableau legs afin de fournir les détails des arrêts de cette section du trajet. Définissez cette valeur sur "true" si vous souhaitez que l'itinéraire passe par ce point de cheminement sans s'arrêter. Les points de cheminement via des points de cheminement n'entraînent pas l'ajout d'une entrée au tableau legs , mais ils guident le trajet par le point de cheminement. Vous ne pouvez définir cette valeur que sur des points de cheminement intermédiaires. La requête échoue si vous définissez ce champ sur les points de cheminement terminaux. Si ComputeRoutesRequest.optimize_waypoint_order est défini sur "true", ce champ ne peut pas être défini sur "true". Sinon, la requête échoue.
|
vehicleStopover |
boolean
Indique que le point de cheminement est destiné aux véhicules, et que l'intention est de monter ou de descendre. Lorsque vous définissez cette valeur, l'itinéraire calculé n'inclut pas les points de cheminement autres que via sur les routes non adaptées aux lieux de prise en charge et de dépose. Cette option ne fonctionne que pour les modes de transport DRIVE et TWO_WHEELER , et lorsque la valeur de locationType est Location .
|
sideOfRoad |
boolean
Indique que l'emplacement de ce point de cheminement doit être prioritaire pour que le véhicule s'arrête à un côté de la route en particulier. Lorsque vous définissez cette valeur, l'itinéraire passe par l'emplacement afin que le véhicule puisse s'arrêter sur le côté de la route vers lequel l'emplacement est orienté à partir du centre. Cette option ne fonctionne que pour DRIVE et TWO_WHEELER RouteTravelMode .
|
Champ d'union location_type . Différentes manières de représenter un lieu. location_type ne peut être qu'un des éléments suivants : |
location |
object (Location )
Point spécifié à l'aide de coordonnées géographiques, y compris un en-tête facultatif.
|
placeId |
string
ID de lieu du POI associé au point de cheminement.
|
address |
string
Adresse lisible ou plus code. Pour en savoir plus, consultez https://plus.codes.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]