Les points de cheminement peuvent inclure des modificateurs de position pour modifier la manière dont les itinéraires sont calculés, y compris les paramètres pour heading et sideOfRoad.
Spécifier l'orientation du véhicule
Pour définir un point de cheminement, vous spécifiez l'emplacement géographique (REST) ou la position (gRPC) sous la forme d'une paire de coordonnées de latitude/longitude.
La position vous permet également de spécifier la direction que le véhicule doit emprunter 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 d'orientation sont des nombres entiers qui correspondent aux directions de la boussole et varient donc de 0 à 359. Par exemple, une valeur de 0 indique une direction de cap vers le 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 un côté de la route
Pour représenter un emplacement, créez 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 des itinéraires, un itinéraire peut toujours définir un arrêt de l'autre côté 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 indique une préférence pour que le véhicule s'arrête du même côté de la route que celui spécifié par l'emplacement.
Spécifiez que l'itinéraire emprunte le côté de la route souhaité en définissant la propriété sideOfRoad du point de cheminement 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
},
...