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

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

Spécifier le cap du véhicule

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

L'emplacement vous permet également de spécifier la direction que le véhicule doit prendre 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 récupéré. 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 correspondent aux directions de la boussole et sont donc comprises entre 0 et 359. Par exemple, une valeur de 0 indique une direction de cap 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é

Pour représenter un lieu, vous devez créer un objet Waypoint (REST) ou Waypoint (gRPC). Une zone géographique définie par une paire de latitude et de longitude peut correspondre à un côté spécifique d'une route. Toutefois, pour prendre en charge l'optimisation des itinéraires, un itinéraire peut toujours définir une étape 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 le véhicule doit s'arrêter 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é sideOfRoad du point de repère sur true. L'itinéraire passe ensuite par le lieu afin que le véhicule puisse s'arrêter du côté de la route vers lequel le lieu est orienté.

L'exemple suivant montre comment définir sideOfRoad pour un point de repère.

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