Définir un point à traverser

Par défaut, les points de cheminement intermédiaires sont utilisés pour les arrêts de ramassage et de dépôt, mais vous pouvez également spécifier qu'un point de cheminement intermédiaire est uniquement destiné à passer.

Un itinéraire contenant un point de cheminement de départ, un point de cheminement intermédiaire de passthrough et un point de cheminement de destination ne comporte qu'une seule section qui relie le point de départ à la destination, en passant par le point de cheminement intermédiaire (appelé via).

Configurez un point de cheminement intermédiaire en tant que point de cheminement de transit en définissant la propriété via du point de cheminement sur true à l'aide de Waypoint (REST) ou de Waypoint (gRPC).

La propriété via est la plus efficace pour créer des itinéraires en réponse au fait que l'utilisateur fait glisser les points de cheminement sur la carte. Cela permet à l'utilisateur de voir à quoi ressemblera l'itinéraire final en temps réel et de s'assurer que les points de cheminement sont placés à des endroits accessibles à Compute Routes.

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

L'exemple suivant montre comment marquer un point de cheminement intermédiaire comme point de cheminement de transit.

{
  "location": {
    "latLng": {
      "latitude":37.419734,
      "longitude":-122.0827784
    }
  },
  "via": true
}

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

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

Remarque :Si un point de cheminement est spécifié en tant qu'ID de lieu ou en tant que coordonnées de latitude/longitude, il est exclu des résultats de recherche d'ID de lieu.

Pour chaque élément du tableau intermediates, utilisez la propriété intermediateWaypointRequestIndex pour déterminer quel point de cheminement intermédiaire de la requête correspond à l'ID de lieu de la réponse.

Exemple :

• Vous spécifiez trois points de cheminement intermédiaires dans une requête. Deux de ces points de cheminement sont spécifiés par des chaînes d'adresse et un par des coordonnées de latitude/longitude.

• Vous devez inclure geocodingResults dans le masque de champ de réponse pour spécifier le tableau geocodingResults à renvoyer dans les résultats.

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "intermediates": [
    {
      "address": "450 Serra Mall, Stanford, CA 94305, USA"
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    },
    {
      "address": "1836 El Camino Real, Redwood City, CA 94063"
    }
  ],
  "travelMode": "DRIVE",
}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs,geocodingResults'
'https://routes.googleapis.com/directions/v2:computeRoutes'

La réponse inclut le tableau geocodingResults contenant l'ID de lieu pour le point de départ, la destination et deux des trois points de cheminement. Il s'agit des points de cheminement aux indices 0 et 2 de la requête. Étant donné que le point de cheminement à l'indice 1 de la requête a été spécifié à l'aide de coordonnées de latitude/longitude, il est omis du tableau geocodingResults dans la réponse.

{
  "routes": [{...}],
  "geocodingResults": {
    "origin": {
      "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJj38IfwK6j4ARNcyPDnEGa9g"
    },
    "destination": {
     "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJI7ES6tl_j4ARVpDZoXbWAiY"
    },
    "intermediates": [
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 0,
        "type": [
            "street_address"
        ],
        "placeId": "ChIJvdLMGyq7j4ARScE5tWX_C0Y"
      },
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 2,
        "type": [
          "premise"
        ],
        "placeId": "ChIJkTc0GKajj4AR9UMsOSHwGD0"
      }
    ]
  }
}