Les points de cheminement peuvent inclure des modificateurs de lieu pour modifier la façon dont les itinéraires sont calculés, y compris les paramètres pour heading et sideOfRoad.
Spécifier le cap du véhicule
Pour définir un point de cheminement, vous spécifiez l'emplacement géographique (REST) ou l'emplacement (gRPC) sous la forme d'une paire de coordonnées de latitude/longitude.
La position vous permet également de spécifier la direction que vous souhaitez que le véhicule prenne lorsqu'il arrive à chaque point de cheminement. Vous pouvez utiliser cette fonctionnalité pour vous assurer que le véhicule arrive du même côté de la route que le client qui attend d'être pris en charge. Si vous ne spécifiez pas de cap, le véhicule peut arriver du mauvais côté de la route.
Les valeurs de cap sont des nombres entiers qui correspondent aux directions de la boussole et sont donc comprises entre 0 et 359. Par exemple, une valeur de 0 indique une direction plein nord.
L'exemple suivant montre comment définir un heading pour un point de cheminement.
{
"origin":{
"location":{
"latLng":{
"latitude": 37.419734,
"longitude": -122.0827784
},
"heading": 127
}
},
...Spécifier une préférence de côté de la route
Vous représentez un emplacement en créant un objet Waypoint (REST) ou Waypoint (gRPC). Un emplacement défini par une paire de latitude et de longitude peut correspondre à un côté spécifique d'une route. Toutefois, pour permettre l'optimisation de l'itinéraire, un itinéraire peut toujours définir une étape du côté opposé de la route par rapport à l'emplacement spécifié.
Les points de cheminement sont compatibles avec la propriété sideOfRoad, qui indique que l'emplacement du point de cheminement est de préférence du même côté de la route que celui spécifié par l'emplacement.
Spécifiez que l'itinéraire utilise le côté préféré de la route en définissant la propriété Waypoint sideOfRoad sur true. L'itinéraire passe ensuite par l'emplacement afin que le véhicule puisse s'arrêter du côté de la route vers lequel l'emplacement est orienté.
L'exemple suivant montre comment définir sideOfRoad pour un point de cheminement.
{
"origin":{
"location":{
"latLng":{
"latitude": 37.419734,
"longitude": -122.0827784
}
},
"sideOfRoad": true
},
...