Solicitud y respuesta de descriptores de direcciones

Desarrolladores del Espacio Económico Europeo (EEE)

Los descriptores de direcciones incluyen información adicional que ayuda a describir una ubicación con puntos de referencia y áreas. Consulta la demostración de los descriptores de dirección para explorar la función.

Parámetros adicionales

Los descriptores de dirección se pueden habilitar con 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 Places para recibir descriptores de direcciones en tu respuesta.

Ejemplo en Geocoding

La siguiente búsqueda 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 en Geocoding de lugares

La siguiente búsqueda contiene el ID de lugar de un lugar 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 búsqueda 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&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" ]
        }
     ]
  }
}

Cada objeto address_descriptor contiene dos arrays: landmarks y areas. El array landmarks contiene hasta 5 resultados clasificados en orden de relevancia teniendo en cuenta la proximidad a la coordenada solicitada, la prevalencia del punto de referencia y su visibilidad. Cada resultado de referencia contiene los siguientes valores:

  • place_id es el ID de lugar del resultado de lugares de interés. Consulta la descripción general del ID de lugar.
  • display_name es el nombre visible del punto de referencia y contiene language_code y text.
  • straight_line_distance_meters es la distancia punto a punto en metros entre la coordenada de entrada y el resultado de las referencias.
  • travel_distance_meters es la distancia en metros recorrida a través de la red de rutas (sin tener en cuenta las restricciones de las rutas) entre la coordenada de entrada y el resultado de las referencias.
  • spatial_relationship es la relación estimada entre la coordenada de entrada y el resultado de las marcas viales:
    • "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 al punto de referencia.
    • "BESIDE" cuando la coordenada de entrada está directamente adyacente al punto de referencia o al punto de acceso del punto de referencia
    • "ACROSS_THE_ROAD" cuando la coordenada de entrada se encuentra directamente opuesta a la referencia del otro lado de la ruta.
    • "DOWN_THE_ROAD" cuando la coordenada de entrada se encuentra a lo largo de la misma ruta que el punto de referencia, pero no es "BESIDES" ni "ACROSS_THE_ROAD".
    • "AROUND_THE_CORNER" cuando la coordenada de entrada se encuentra a lo largo de una ruta perpendicular a la referencia (restringida a un solo giro).
    • "BEHIND" cuando la coordenada de entrada está cerca del punto de referencia en el espacio, 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 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 contiene language_code y text.
  • containment es la relación de contención estimada entre la coordenada de entrada y el resultado de á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

Los descriptores de direcciones están disponibles en todas las regiones. Consulta la cobertura regional para obtener más detalles.

Comentarios

Esta función está disponible en todas las regiones y se encuentra en la etapa de lanzamiento experimental previa a la DG para todas las demás regiones, y en DG para la India. Agradeceríamos tus comentarios. Envíanos un correo electrónico a address-descriptors-feedback@google.com.