Requête et réponse de descripteurs d'adresse

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

Les descripteurs d'adresse incluent des informations supplémentaires qui aident à décrire un lieu à l'aide de points de repère et de zones. Consultez la démonstration des descripteurs d'adresse pour découvrir cette fonctionnalité.

Paramètres supplémentaires

Les descripteurs d'adresse peuvent être activés à l'aide du paramètre extra_computations. Incluez extra_computations=ADDRESS_DESCRIPTORS dans une requête de geocoding, une requête de geocoding inversé ou une requête de geocoding de lieux pour recevoir des descripteurs d'adresse dans votre réponse.

Exemple de géocodage

La requête suivante contient l'adresse d'un lieu à Delhi :

https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

Exemple de geocoding de lieux

La requête suivante contient l'ID de lieu d'un lieu à Delhi :

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

Exemple de geocoding inversé

La requête suivante contient la valeur de latitude/longitude d'un lieu à Delhi :

https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

Réponse

Voici un exemple de address_descriptor :

{
  "address_descriptor" : {
     "areas" : [
        {
           "containment" : "OUTSKIRTS",
           "display_name" : {
              "language_code" : "en",
              "text" : "Turkman Gate"
           },
           "place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
        },
        {
           "containment" : "OUTSKIRTS",
           "display_name" : {
              "language_code" : "en",
              "text" : "Chandni Chowk"
           },
           "place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
        },
        {
           "containment" : "NEAR",
           "display_name" : {
              "language_code" : "en",
              "text" : "Katar Ganj"
           },
           "place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
        }
     ],
     "landmarks" : [
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Delite Cinema"
           },
           "straight_line_distance_meters" : 29.9306755065918,
           "place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
           "travel_distance_meters" : 418.7794799804688,
           "spatial_relationship" : "ACROSS_THE_ROAD",
           "types" : [ "establishment", "movie_theater", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "YES Bank"
           },
           "straight_line_distance_meters" : 66.83731079101562,
           "place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
           "travel_distance_meters" : 489.0340270996094,
           "spatial_relationship" : "DOWN_THE_ROAD",
           "types" : [ "bank", "establishment", "finance", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "UCO Bank"
           },
           "straight_line_distance_meters" : 25.38849639892578,
           "place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
           "travel_distance_meters" : 403.2246398925781,
           "spatial_relationship" : "ACROSS_THE_ROAD",
           "types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Delhi By Cycle Meeting Point"
           },
           "straight_line_distance_meters" : 44.02867126464844,
           "place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
           "travel_distance_meters" : 97.41281890869141,
           "spatial_relationship" : "AROUND_THE_CORNER",
           "types" : [
              "establishment",
              "point_of_interest",
              "tourist_attraction",
              "travel_agency"
           ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Axis Bank Branch"
           },
           "straight_line_distance_meters" : 102.3495178222656,
           "place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
           "travel_distance_meters" : 330.8566284179688,
           "spatial_relationship" : "DOWN_THE_ROAD",
           "types" : [ "bank", "establishment", "finance", "point_of_interest" ]
        }
     ]
  }
}

Chaque objet address_descriptor contient deux tableaux : landmarks et areas. Le tableau landmarks contient jusqu'à cinq résultats classés par pertinence en tenant compte de la proximité avec les coordonnées demandées, de la prévalence du point de repère et de sa visibilité. Chaque résultat de point de repère contient les valeurs suivantes :

  • place_id est l'ID de lieu du résultat de points de repère. Consultez la présentation des ID de lieu.
  • display_name est le nom à afficher du repère et contient language_code et text.
  • straight_line_distance_meters correspond à la distance point à point en mètres entre la coordonnée saisie et le résultat des repères.
  • travel_distance_meters correspond à la distance en mètres parcourue sur le réseau routier (en ignorant les restrictions routières) entre les coordonnées saisies et le résultat des points de repère.
  • spatial_relationship correspond à la relation estimée entre la coordonnée d'entrée et le résultat des points de repère :
    • "NEAR" est la relation par défaut lorsqu'aucune des conditions suivantes ne s'applique.
    • "WITHIN" lorsque la coordonnée d'entrée est contenue dans les limites de la structure associée au repère.
    • "BESIDE" lorsque la coordonnée d'entrée est directement adjacente au point de repère ou à son point d'accès.
    • "ACROSS_THE_ROAD" lorsque la coordonnée d'entrée est directement opposée au repère de l'autre côté de l'itinéraire.
    • "DOWN_THE_ROAD" lorsque la coordonnée d'entrée se trouve sur le même itinéraire que le point de repère, mais pas "BESIDES" ni "ACROSS_THE_ROAD".
    • "AROUND_THE_CORNER" lorsque la coordonnée d'entrée se trouve sur un itinéraire perpendiculaire au point de repère (limité à un seul virage).
    • "BEHIND" lorsque la coordonnée d'entrée est spatialement proche du point de repère, mais éloignée de son point d'accès.
  • types correspond aux types de lieux du point de repère.

L'objet areas contient jusqu'à trois réponses et se limite aux lieux qui représentent de petites régions, comme les quartiers, les sous-localités et les grands complexes. Les zones contenant les coordonnées demandées sont listées en premier et classées de la plus petite à la plus grande. Chaque résultat areas contient les valeurs suivantes :

  • place_id est l'ID de lieu du résultat des zones. Consultez la présentation des ID de lieu.
  • display_name est le nom à afficher de la zone et contient language_code et text.
  • containment correspond à la relation de confinement estimée entre la coordonnée d'entrée et le résultat des zones :
    • "NEAR" est la relation par défaut lorsqu'aucune des conditions suivantes ne s'applique.
    • "WITHIN" lorsque la coordonnée d'entrée est proche du centre de la zone.
    • "OUTSKIRTS" lorsque la coordonnée d'entrée est proche du bord de la zone.

Couverture

Les descripteurs d'adresse sont disponibles dans toutes les régions. Pour en savoir plus, consultez la couverture géographique.

Commentaires

Cette fonctionnalité est disponible dans toutes les régions. Elle est en disponibilité générale pour l'Inde et en phase de lancement expérimental (pré-DG) pour toutes les autres régions. Nous vous remercions de vos commentaires. Veuillez nous envoyer un e-mail à l'adresse address-descriptors-feedback@google.com.