Les descripteurs d'adresse renvoient des informations supplémentaires par rapport à la réponse de geocoding inversé standard qui permet de décrire les coordonnées de latitude et de longitude à l'aide de points de repère et de zones. Consultez la démonstration des descripteurs d'adresse pour découvrir l'API.
Requêtes de geocoding inversé - Paramètres supplémentaires
Paramètres facultatifs
Voici les paramètres facultatifs que vous pouvez inclure dans une requête de geocoding inversé:
enable_address_descriptor: paramètre booléen à inclure dans la requête de geocoding inversé pour ajouter le descripteur d'adresse à la réponse de geocoding inversé standard.
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&key=YOUR_API_KEY&enable_address_descriptor=true
Réponse
La requête ci-dessus renvoie un address_descriptor supplémentaire comme suit:
{
"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" ]
}
]
},
... Results (reverse geocoding response) ...
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é par rapport à 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_idest l'ID de lieu du résultat de points de repère. Consultez la présentation des ID de lieu.display_nameest le nom à afficher du point de repère, et contientlanguage_codeettext.straight_line_distance_metersest la distance entre le point à point, exprimée en mètres, entre les coordonnées d'entrée et le résultat du point de repère.travel_distance_meterscorrespond à la distance en mètres parcourue sur le réseau routier (en ignorant les restrictions de circulation) entre les coordonnées d'entrée et le résultat du point de repère.spatial_relationshipest 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 situations suivantes ne s'applique."WITHIN"lorsque la coordonnée d'entrée est contenue dans les limites de la structure associée au point de repère."BESIDE"lorsque la coordonnée d'entrée est directement adjacente au point d'accès du point de repère ou du point d'accès."ACROSS_THE_ROAD"lorsque la coordonnée d'entrée est directement opposée au point de repère 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'une route perpendiculaire en tant que point de repère (limité à un seul virage)."BEHIND"lorsque la coordonnée d'entrée est proche du point de repère dans l'espace, mais éloigné de son point d'accès.typescorrespond au type de lieu du point de repère.
L'objet areas contient jusqu'à trois réponses et se limite aux lieux représentant de petites régions, tels que les quartiers, les sous-localités et les grands complexes. Les zones qui contiennent les coordonnées demandées sont répertoriées en premier, classées de la plus petite à la plus grande. Chaque résultat areas contient les valeurs suivantes:
place_idest l'ID de lieu du résultat de zones. Consultez la présentation des ID de lieu.display_nameest le nom à afficher de la zone. Il contientlanguage_codeettext.containmentest la relation de confinement estimée entre la coordonnée d'entrée et le résultat de la zone:"NEAR"est la relation par défaut lorsqu'aucune des situations 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é expérimentale. N'hésitez pas à nous faire part de vos commentaires. Veuillez nous envoyer un e-mail à l'adresse address-descriptors-feedback@google.com.