Les descripteurs d'adresse incluent des informations supplémentaires qui permettent de décrire un lieu à l'aide de points de repère et de zones. Consultez la démonstration sur les descripteurs d'adresse pour explorer l'élément géographique.
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 les descripteurs d'adresses dans votre réponse.
Exemple dans le geocoding
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 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 pertinence en tenant compte de la proximité avec la coordonnée demandée, 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 des points de repère. Consultez la présentation des ID de lieu.display_name
est le nom à afficher du point de repère, et contientlanguage_code
ettext
.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 parcourue en mètres via le réseau routier (en ignorant les restrictions de circulation) entre les coordonnées d'entrée et le résultat des points de repère.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 lorsqu'aucune des conditions suivantes ne s'applique."WITHIN"
lorsque la coordonnée d'entrée est comprise dans les limites de la structure associée au point de repère."BESIDE"
lorsque les coordonnées d'entrée sont directement adjacentes au point d'accès ou au point d'accès."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 sont répertorié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. Il contientlanguage_code
ettext
.containment
est la relation de confinement estimée entre la coordonnée d'entrée et le résultat de l'aire:"NEAR"
est la relation par défaut lorsqu'aucune des conditions suivantes ne s'applique."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
Cette fonctionnalité n'est disponible que dans certains pays.
Commentaires
Il s'agit d'une fonctionnalité en preview, et nous aimerions connaître votre avis. Veuillez nous envoyer un e-mail à l'adresse address-descriptors-feedback@google.com.