Définir un point à traverser

Développeurs de l'Espace économique européen (EEE)

Si votre adresse de facturation se trouve dans l'Espace économique européen, les Conditions d'utilisation de Google Maps Platform pour l'EEE s'appliqueront à votre utilisation des Services à compter du 8 juillet 2025. La fonctionnalité varie selon la région. En savoir plus

Par défaut, les points de chemin intermédiaires sont utilisés pour les arrêts de prise en charge et de dépose, mais vous pouvez également spécifier qu'un point de chemin intermédiaire est destiné uniquement au passage.

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 section 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 comme 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 plus efficace lorsque vous créez des itinéraires en réponse au déplacement des waypoints par l'utilisateur sur la carte. Cela permet à l'utilisateur de voir à quoi pourrait ressembler l'itinéraire final en temps réel et de s'assurer que les waypoints sont placés dans des lieux accessibles à la bibliothèque Routes.

Attention : Si vous utilisez le champ via pour éviter les arrêts, les résultats interprètent le point de cheminement de manière stricte dans l'itinéraire. Cette interprétation peut entraîner des détours importants ou un code d'état ZERO_RESULTS dans la réponse si l'API Maps JavaScript ne peut pas créer d'itinéraire passant par ce point.

Exemple de requête

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

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 repère, ainsi que des données supplémentaires sur l'emplacement.

Remarque : Si un point de cheminement est spécifié sous forme d'ID de lieu ou de coordonnées de latitude/longitude, il est omis des résultats de la recherche d'ID de lieu.

Exemple de réponse de résultats de géocodage

{
  "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
    }
  ]
}