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.

Indiquez la direction du véhicule

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

La localisation 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. 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 d'orientation, le véhicule peut arriver du mauvais côté de la route.

Les valeurs de titre sont des nombres entiers alignés sur les directions de la boussole. Elles sont donc comprises entre 0 et 359. Par exemple, une valeur de 0 indique une direction de direction 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 à privilégier

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 permettre l'optimisation de l'itinéraire, un itinéraire peut toujours définir un arrêt de sorte qu'il se trouve du côté opposé à 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 a une préférence pour que le véhicule s'arrête au même côté de la route que celui spécifié par l'emplacement.

Indiquez 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 sur le 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
  },
  ...