Los descriptores de direcciones muestran información adicional a la respuesta de geocodificación inversa estándar que ayuda a describir las coordenadas de latitud y longitud mediante el uso de puntos de referencia y áreas. Para explorar la API, consulta la demostración de descriptores de direcciones.
Solicitudes de geocodificación inversa: parámetros adicionales
Parámetros opcionales
Estos son los parámetros opcionales que puedes incluir en una solicitud de geocodificación inversa:
enable_address_descriptor
: Es un parámetro booleano que se debe incluir con la solicitud de geocodificación inversa para agregar el descriptor de dirección a la respuesta de geocodificación inversa estándar.
Ejemplo de geocodificación inversa
La siguiente consulta contiene el valor de latitud y longitud de una ubicación en Delhi:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&key=YOUR_API_KEY&enable_address_descriptor=true
Respuesta
La consulta anterior muestra un address_descriptor
adicional de la siguiente manera:
{
"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) ...
Hay dos arrays en cada objeto address_descriptor
: landmarks
y areas
. El array landmarks
contiene hasta 5 resultados clasificados en orden de relevancia según la proximidad a la coordenada solicitada, la prevalencia del punto de referencia y su visibilidad. Cada resultado de punto de referencia contiene los siguientes valores:
place_id
es el ID de lugar del resultado de los puntos de referencia. Consulta la descripción general del ID de lugar.display_name
es el nombre visible del punto de referencia y contienelanguage_code
ytext
.straight_line_distance_meters
es la distancia de punto a punto en metros entre la coordenada de entrada y el resultado de los puntos de referencia.travel_distance_meters
es la distancia en metros recorrida a través de la red de rutas (sin considerar las restricciones de rutas) entre la coordenada de entrada y el resultado de los puntos de referencia.spatial_relationship
es la relación estimada entre la coordenada de entrada y el resultado de los puntos de referencia:"NEAR"
es la relación predeterminada cuando no se aplica ninguna de las siguientes opciones."WITHIN"
cuando la coordenada de entrada se encuentra dentro de los límites de la estructura asociada con el punto de referencia."BESIDE"
cuando la coordenada de entrada se encuentra directamente adyacente al punto de acceso del punto de acceso o del punto de acceso."ACROSS_THE_ROAD"
cuando la coordenada de entrada se encuentra directamente opuesta al punto de referencia en el otro lado de la ruta."DOWN_THE_ROAD"
cuando la coordenada de entrada se encuentra en la misma ruta que el punto de referencia, pero no en"BESIDES"
ni"ACROSS_THE_ROAD"
."AROUND_THE_CORNER"
cuando la coordenada de entrada se encuentra en una ruta perpendicular como punto de referencia (restringido a un solo giro)."BEHIND"
cuando la coordenada de entrada se encuentra espacialmente cerca del punto de referencia, pero lejos de su punto de acceso.types
son los tipos de lugar del punto de referencia.
El objeto areas
contiene hasta 3 respuestas y se limita a lugares que representan regiones pequeñas, como vecindarios, sublocalidades y complejos grandes. Las áreas que contienen la coordenada solicitada se enumeran primero y se ordenan de la más pequeña a la más grande. Cada resultado de areas
contiene los siguientes valores:
place_id
es el ID de lugar del resultado de las áreas. Consulta la descripción general del ID de lugar.display_name
es el nombre visible del área y contienelanguage_code
ytext
.containment
es la relación de contención estimada entre la coordenada de entrada y el resultado de las áreas:"NEAR"
es la relación predeterminada cuando no se aplica ninguna de las siguientes opciones."WITHIN"
cuando la coordenada de entrada está cerca del centro del área."OUTSKIRTS"
cuando la coordenada de entrada está cerca del borde del área.
Cobertura
Esta función solo está disponible en determinados países.
Comentarios
Esta función se encuentra en fase experimental, por lo que agradeceríamos que nos envíes comentarios. Envíanos un correo electrónico a address-descriptors-feedback@google.com.