Los descriptores de dirección incluyen información adicional que ayuda a describir una ubicación mediante puntos de referencia y áreas. Consulta la demostración de descriptores de dirección para explorar la función.
Parámetros adicionales
Los descriptores de direcciones pueden habilitarse mediante el parámetro extra_computations
. Incluye extra_computations=ADDRESS_DESCRIPTORS
en una solicitud de geocodificación, una solicitud de geocodificación inversa o una solicitud de geocodificación de lugares para recibir descriptores de dirección en tu respuesta.
Ejemplo de geocodificación
La siguiente consulta contiene la dirección de un lugar en 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
Ejemplo de geocodificación de lugares
La siguiente consulta contiene el ID de un sitio en Delhi:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Ejemplo de geocodificación inversa
La siguiente consulta contiene el valor de latitud y longitud para una ubicación en Delhi:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Respuesta
A continuación, se muestra un ejemplo 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" ]
}
]
}
}
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 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 por la red de rutas (ignorando las restricciones de rutas) entre las coordenadas 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 está contenida dentro de los límites de la estructura asociada con el punto de referencia."BESIDE"
cuando la coordenada de entrada es directamente adyacente al punto de referencia o al punto de acceso del punto de acceso."ACROSS_THE_ROAD"
cuando la coordenada de entrada es directamente opuesta al punto de referencia al otro lado de la ruta.- Es
"DOWN_THE_ROAD"
cuando la coordenada de entrada está en la misma ruta que el punto de referencia, pero no"BESIDES"
ni"ACROSS_THE_ROAD"
. "AROUND_THE_CORNER"
cuando la coordenada de entrada se encuentra a lo largo de una ruta perpendicular como el punto de referencia (restringido a un solo giro)."BEHIND"
cuando la coordenada de entrada está 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 las coordenadas solicitadas se muestran primero y se ordenan de menor a mayor. Cada resultado de areas
contiene los siguientes valores:
place_id
es el ID de lugar del resultado de á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 ciertos países.
Comentarios
Esta es una función de versión preliminar y nos gustaría recibir comentarios. Envíanos un correo electrónico a address-descriptors-feedback@google.com.