Points de navigation

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'itinéraire sur un réseau routier à partir ou vers l'établissement. Chaque point de navigation contient les valeurs suivantes:

  • location contient la valeur latitude, longitude du point de navigation. Cet emplacement est 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 ou en revenir. Le point est intentionnellement légèrement décalé par rapport à la ligne médiane de la route afin de marquer 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 transport correspondant aux itinéraires en voiture.
    • "WALK" est le mode de déplacement correspondant aux 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 ayant une position précise, comme les adresses, les bâtiments et les établissements. Les lieux qui représentent de grandes zones, comme les villes et les régions, où une position précise peut être ambiguë, peuvent ne pas renvoyer de points de navigation.

Avis de migration

À partir du 17 avril, vous devez fournir le paramètre de calculs supplémentaires NAVIGATION_POINTS dans la requête pour recevoir des points de navigation. Les clients peuvent le vérifier en confirmant 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:

Pour chacune 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 géocoding de lieu pour obtenir des points de navigation pour un restaurant situé à Mountain View (Californie, É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 de 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. N'hésitez pas à nous faire part de vos commentaires à l'adresse [email protected].