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

Les descripteurs d'adresse contiennent des informations supplémentaires qui permettent de décrire un lieu. en utilisant des points de repère et des zones. Regardez la démonstration sur les descripteurs d'adresse. pour explorer la fonctionnalité.

Paramètres supplémentaires

Vous pouvez activer les descripteurs d'adresse à l'aide du paramètre extra_computations. Incluez extra_computations=ADDRESS_DESCRIPTORS dans une requête de géocodage, une requête de géocodage inversé ou une requête de géocodage 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 établissement à 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 dans le 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 ordre de la pertinence en tenant compte de la proximité avec les coordonnées demandées, 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 des points de repère. Voir l'identifiant de lieu présentation.
• display_name est le nom à afficher du point de repère, et contient language_code et text.
• straight_line_distance_meters est la distance point à point exprimée en mètres entre les coordonnées d'entrée et le résultat des points de repère.
• travel_distance_meters correspond à la distance en mètres parcourue via le réseau routier (en ignorant les restrictions routières) entre la coordonnée d'entrée et le résultat des repères.
• spatial_relationship est la relation estimée entre les coordonnées d'entrée et le résultat des points de repère:
• "NEAR" est la relation par défaut lorsque l'une des conditions suivantes ne s'applique pas.
• "WITHIN" lorsque la coordonnée d'entrée se trouve dans les limites de la structure associée au repère.
• "BESIDE" lorsque les coordonnées saisies sont directement adjacentes au repère ou au point d'accès du repère.
• "ACROSS_THE_ROAD" lorsque les coordonnées d'entrée sont directement opposées au point de repère situé de l'autre côté de l'itinéraire.
• "DOWN_THE_ROAD" lorsque les coordonnées d'entrée se trouvent sur le même itinéraire que le point de repère, mais pas "BESIDES" ni "ACROSS_THE_ROAD".
• "AROUND_THE_CORNER" lorsque les coordonnées d'entrée se trouvent le long d'un itinéraire perpendiculaire en tant que 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 sont les types de lieu 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, telles que les quartiers, les sous-localités et les grands complexes. Les zones contenant les coordonnées demandées s'affichent en premier. classées du plus petit au plus grand. Chaque résultat areas contient les éléments suivants : :

• 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 structuration estimée entre la coordonnée d'entrée et le résultat des zones :
• "NEAR" est la relation par défaut lorsque l'une des conditions suivantes ne s'applique pas.
• "WITHIN" lorsque les coordonnées d'entrée sont proches 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 section Couverture par région.

Commentaires

Il s'agit d'une fonctionnalité en preview, et nous aimerions connaître votre avis. Veuillez envoyer un e-mail à l'adresse address-descriptors-feedback@google.com.