Points de navigation

Important : Cette fonctionnalité expérimentale a été remplacée par le point de terminaison SearchDestinations de la nouvelle API Geocoding v4. Utilisez plutôt ce point de terminaison si vous souhaitez obtenir les points de navigation d'un lieu.

Ce produit ou cette fonctionnalité est en phase expérimentale (pré-DG). La prise en charge des fonctionnalités et produits pré-DG peut être limitée, et il se peut que les modifications apportées à ces fonctionnalités ou produits ne soient pas compatibles avec d'autres versions pré-DG. Les offres en pré-DG sont couvertes par les Conditions spécifiques du service Google Maps Platform. Pour en savoir plus, consultez les descriptions des étapes de lancement.

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

Le champ navigation_points de la réponse de géocodage contient une liste de points utiles pour accéder au lieu. Plus précisément, ils doivent être utilisés comme points de départ ou d'arrivée lors de l'acheminement sur un réseau routier depuis ou vers le lieu. Chaque point de navigation contient les valeurs suivantes :

• location contient la valeur de latitude et de longitude du point de navigation. Cet emplacement sera toujours très proche du réseau routier et constitue un point de départ ou d'arrivée idéal pour se rendre à un endroit. Le point est intentionnellement légèrement décalé par rapport à l'axe de la route pour indiquer clairement le côté de la route où se trouve le lieu.
• restricted_travel_modes est une liste des modes de transport à partir desquels le point de navigation n'est pas accessible :
• "DRIVE" correspond au mode de déplacement pour les itinéraires en voiture.
• "WALK" correspond au mode de déplacement pour les itinéraires à pied.
• road_name contient le nom de la route par rapport à laquelle le point de navigation est décalé.

Des points de navigation sont renvoyés pour la plupart des lieux avec une position précise, comme les adresses, les bâtiments et les établissements. Les lieux qui représentent de grandes zones, comme des villes et des régions, où une position précise peut être ambiguë, peuvent ne renvoyer aucun point de navigation.

Avis de migration

Depuis le 17 avril, vous devez fournir le paramètre NAVIGATION_POINTS extra computations dans la requête pour recevoir des points de navigation. Les clients peuvent tester cela en vérifiant que le champ road_name de certains points de navigation est renvoyé et que le champ location de chaque point de navigation comporte les quatre sous-champs suivants (lat, lng, latitude, longitude).

De plus, vous devez migrer vers les champs location.lat et location.lng plutôt que vers les champs location.latitude et location.longitude. Dans une prochaine version, les requêtes qui ne contiennent pas le paramètre de calculs supplémentaires NAVIGATION_POINTS n'incluront aucun point de navigation dans la réponse, et les champs location.latitude et location.longitude ne seront plus renvoyés.

Informations sur la demande

Vous pouvez obtenir des points de navigation dans les types de requêtes suivants :

• Demande de géocodage
• Demande de géocodage inversé
• Envoyer une demande de géocodage de lieu

Pour l'une de ces requêtes, vous devez fournir le paramètre suivant : extra_computations=NAVIGATION_POINTS.

Exemple de requête

La requête suivante utilise le geocoding de lieux pour obtenir des points de navigation pour un restaurant à Mountain View, en Californie, aux États-Unis :

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY

Exemple de réponse

La réponse à la requête ci-dessus affiche un tableau de points de navigation :

{
  "navigation_points": [
    {
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Castro Street"
    },
    {
      "location": {
        "lat": 37.394273,
        "lng": -122.0793078,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Wild Cherry Lane"
    },
    {
      "location": {
        "lat": 37.3941202,
        "lng": -122.0789189,
      },
      "restricted_travel_modes": ["DRIVE"]
    }
  ]
}

Commentaires

Cette fonctionnalité est expérimentale. Nous vous invitons à nous faire part de vos commentaires à l'adresse [e-mail].