Indiquer le cap et le côté de la route

Les points de cheminement peuvent inclure des modificateurs d'emplacement pour modifier le mode de calcul des itinéraires, y compris les paramètres de heading et sideOfRoad.

Spécifier la direction du véhicule

Pour définir un point de cheminement, vous spécifiez l'emplacement géographique Location (REST) ou Location (gRPC) sous forme de paire de coordonnées de latitude/longitude.

L'emplacement vous permet également de spécifier la direction dans laquelle vous souhaitez que le véhicule se dirige lorsqu'il arrive à chaque point de cheminement. Cette fonctionnalité permet de s'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 direction, le véhicule peut arriver du mauvais côté de la route.

Les valeurs de direction sont des nombres entiers qui correspondent aux directions de la boussole et qui vont donc de zéro à 359. Par exemple, la valeur 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 un côté de la route préféré

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 escale sur le 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 préfère 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 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
  },
  ...