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 pour heading et sideOfRoad.

Indiquer la direction du véhicule

Pour définir un point de cheminement, vous devez spécifier l'emplacement (REST) ou le emplacement (gRPC) géographiques sous la forme d'une paire de coordonnées de latitude/longitude.

L'emplacement vous permet également de spécifier la direction dans laquelle le véhicule doit suivre 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 consommateur 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'en-tête sont des nombres entiers qui s'alignent sur les directions de la boussole et vont donc de zéro à 359. Par exemple, une valeur de 0 indique une direction de cap en direction du 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
    }
  },
  ...

Indiquer un côté de la préférence

Pour représenter un emplacement, créez un objet Waypoint (REST) ou Waypoint (gRPC). Un emplacement défini par une paire latitude/longitude peut correspondre à un côté spécifique d'une route. Toutefois, pour optimiser l'itinéraire, un itinéraire peut toujours définir un arrêt de son côté opposé à l'emplacement spécifié.

Les points de cheminement sont compatibles avec la propriété sideOfRoad, qui indique que l'emplacement du point de cheminement a 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 utilise le côté de la route à privilégier 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 sur le côté de la route vers lequel l'emplacement est biaisé.

L'exemple suivant montre comment définir sideOfRoad pour un point de cheminement.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    },
    "sideOfRoad": true
  },
  ...