Définir un point à traverser

Par défaut, les points de cheminement intermédiaires sont utilisés pour s'arrêter pour les prises en charge et les déposes, mais vous pouvez également spécifier qu'un point de cheminement intermédiaire est destiné uniquement à être traversé.

Un itinéraire qui contient un point de cheminement de départ, un point de cheminement intermédiaire de passage et un point de cheminement de destination ne contient qu'une seule étape qui relie le point de départ et la destination, tout en passant par le point de cheminement intermédiaire (appelé via).

Configurez un point de cheminement intermédiaire pour qu'il soit un point de cheminement intermédiaire en définissant la propriété via du point de cheminement sur true à l'aide de l'interface Waypoint.

La propriété via est particulièrement efficace lorsque vous créez des itinéraires en réponse au déplacement des points de cheminement par l'utilisateur sur la carte. Cela permet à l'utilisateur de voir à quoi peut ressembler l'itinéraire final en temps réel et de s'assurer que les points de cheminement sont placés à des emplacements accessibles à la bibliothèque Routes.

Exemple de requête

L'exemple de requête suivant montre comment marquer un point de cheminement intermédiaire comme point de cheminement de passage.

const routeRequestWithVia = {
  origin: '100 Moffett Blvd, Mountain View, CA 94043',
  destination: '1199 9th Ave, San Francisco, CA 94122',
  travelMode: 'DRIVING',
  intermediates: [
    {location: 'Half Moon Bay, CA', via: true} // Set the via property to true
  ],
  fields: ['path', 'legs'],
};

// Make the request.
const {routes, fallbackInfo, geocodingResults} = await Route.computeRoutes(routeRequestWithIntermediates);
  

Accéder aux ID de lieu pour les points de cheminement intermédiaires

Si vous spécifiez l'emplacement d'un point de cheminement de départ, de destination ou intermédiaire sous la forme d'une chaîne d'adresse ou d'un Plus Code, la bibliothèque Routes tente de trouver l'emplacement le plus pertinent qui possède un ID de lieu correspondant. Le tableau geocodingResults.intermediates des résultats contient l'ID de lieu correspondant à l'emplacement des points de cheminement, ainsi que des données supplémentaires sur l'emplacement.

Exemple de réponse de résultats de geocoding

{
  "origin": {
    "geocoderStatus": "OK",
    "types": [
      "premise",
      "street_address"
    ],
    "partialMatch": false,
    "placeId": "ChIJb5NgcTa3j4ARrfF4Oc_f6q8",
    "intermediateWaypointRequestIndex": null
  },
  "destination": {
    "geocoderStatus": "OK",
    "types": [
      "premise",
      "street_address"
    ],
    "partialMatch": false,
    "placeId": "ChIJAbIPLl2HhYARQ0SSdDFxU-s",
    "intermediateWaypointRequestIndex": null
  },
  "intermediates": [
    {
      "geocoderStatus": "OK",
      "types": [
        "locality",
        "political"
      ],
      "partialMatch": false,
      "placeId": "ChIJC8sZCqULj4ARVJvnNcic_V4",
      "intermediateWaypointRequestIndex": 0
    }
  ]
}