Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Geocodificación inversa
La geocodificación inversa convierte las coordenadas geográficas en una dirección o un lugar legibles para los humanos. Proporciona información detallada sobre los componentes de la dirección, el tipo de lugar, la categoría y la calle, con opciones de filtrado según el tipo de lugar para ajustar los resultados. La API también puede incluir características adicionales, como información sobre la zona horaria y ajustes de la visión política.
nota
Si los resultados se almacenan, se facturarán según el nivel de precios de almacenamiento superior. Utilice el parámetro IntendedUse para especificar si los resultados son para un solo uso o para almacenamiento. Consulte Precios de lugares para implicaciones de los costos asociados a los resultados almacenados.
Para obtener más información, consulte ReverseGeocode en la Referencia de la API de Amazon Location Service.
Para ver ejemplos de solicitudes, respuestas, cURL y comandos de la CLI para esta API, consulte Cómo usar la Geocodificación inversa.
Casos de uso
-
Agregue datos adicionales a los datos de posición de los clientes: mejore los registros de datos de posición incluyendo códigos postales y coordenadas y utilizando el almacenamiento persistente para respaldar las decisiones comerciales y de marketing fundamentadas.
-
Estandarización de los datos de posición: aplique la geocodificación en las canalizaciones de datos o los procesos por lotes para estandarizar los datos de posición, utilizando el almacenamiento persistente como referencia continua.
-
Determine las zonas horarias: identifique la zona horaria de las ciudades o direcciones para proporcionar marcas temporales precisas para aplicaciones como los viajes, la programación y la facturación.
Explicación de la solicitud
La solicitud de la API de Geocodificación inversa acepta una combinación de parámetros obligatorios y opcionales para personalizar los resultados. El parámetro obligatorio QueryPosition (longitud y latitud) especifica las coordenadas para la geocodificación inversa. Los parámetros opcionales incluyen AdditionalFeatures para datos adicionales, Filter para ajustar los resultados y MaxResults para limitar el número de resultados devueltos. Las opciones adicionales como Language, PoliticalView y IntendedUse permiten una mayor personalización. Para obtener más detalles, consulte la referencia de la API de Geocodificación inversa.
La solicitud acepta los parámetros clave siguientes:
- Autenticación
-
El parámetro
Keyes opcional si se utilizan otros métodos de autenticación.-
Key: parámetro opcional para la autenticación.
Para obtener más información, consulte Autenticación con Amazon Location Service.
-
- Consultas
-
Parámetros utilizados para definir la ubicación geográfica y el radio de búsqueda.
-
QueryPosition: especifica la longitud y la latitud de la solicitud de geocodificación inversa. -
QueryRadius: define el radio de búsqueda alrededor de las coordenadas.
Para obtener más información, consulte Consultas y sesgos.
-
- Ajuste de los resultados
-
Aplica filtros para limitar los resultados de la búsqueda a países o tipos de lugares específicos.
-
Filter: filtre los resultados en función del país o el tipo de lugar.
Para obtener más información, consulta Filtrado.
-
- Internacionalización y localización
-
Opciones para personalizar el idioma y aplicar una visión política a los resultados.
-
Language: especifica el idioma de los resultados. -
PoliticalView: aplica una visión política que refleja las reclamaciones territoriales.
Para obtener más información, consulte Localización e internacionalización.
-
- Características adicionales
-
Solicita datos adicionales, como información sobre la zona horaria.
-
AdditionalFeatures: opción para solicitar datos adicionales, como detalles de la zona horaria.
Para obtener más información, consulte Características adicionales.
-
Explicación de la respuesta
La respuesta de la API de Geocodificación inversa proporciona información detallada sobre las ubicaciones en las coordenadas especificadas. La matriz ResultItems incluye una lista de objetos de lugar, cada uno de los cuales contiene detalles de direcciones, categorías y posición geográfica. Los datos adicionales como TimeZone, FoodTypes, y PostalCodeDetails ofrecen más contexto. La respuesta también incluye información sobre el recuadro delimitador para el mapeo y la distancia desde la posición de la consulta. Para obtener más detalles, consulte la referencia de la API de Geocodificación inversa.
La respuesta incluye los datos de claves siguientes:
- Dirección y detalles relacionados
-
Información detallada de la dirección de la ubicación devuelta.
-
Address: información completa de la dirección, incluidos el país, la región, el código postal y los detalles de la calle. -
PostalCodeDetails: detalles adicionales relacionados con los códigos postales, como las clasificaciones y las autoridades postales. -
StreetComponents: detalles adicionales sobre la calle, incluidos el nombre y el tipo de la base.
-
- Tipos y categorías de lugares
-
Describe el tipo y la categoría del sitio devuelto.
-
Categories: categorías que describen el lugar, como restaurantes o escuelas. -
PlaceType: especifica el tipo de lugar, como una ciudad, una dirección o una región.
-
- Análisis de los resultados
-
Información sobre el grado de coincidencia de cada resultado con la consulta de entrada.
-
MatchScores: puntuaciones que indican la precisión de cada coincidencia con la consulta de entrada.
-
- Detalles adicionales
-
Proporciona datos adicionales relacionados con la ubicación.
-
TimeZone: información de zona horaria de la ubicación. -
AccessPoints: coordenadas geográficas que representan los puntos de entrada a la ubicación.
-
