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.
Geocodificar
La geocodificación transforma las direcciones textuales o los nombres de lugares en coordenadas geográficas, junto con los componentes detallados de las direcciones e información adicional. Esta API admite consultas flexibles, que incluyen tanto texto de formato libre como consultas estructuradas con nombres de calles, códigos postales y regiones. Las funciones opcionales incluyen los datos de zona horaria y los ajustes de la vista política.
nota
Los resultados almacenados tienen un precio de almacenamiento más alto. Utilice el IntendedUse parámetro para indicar un solo uso o almacenamiento. Consulte la Precios de plazas para comprender las implicaciones económicas de los resultados almacenados.
Para obtener más información, consulta Geocode en la referencia de la API de Amazon Location Service.
Para ver ejemplos de solicitudes, respuestas, cURL y comandos CLI para esta API, consulta Cómo usar Geocode.
Casos de uso
-
Agregue datos adicionales a las direcciones de los clientes: mejore los registros de direcciones incluyendo códigos postales y coordenadas y utilizando el almacenamiento persistente para respaldar las decisiones comerciales y de marketing informadas.
-
Estandarización de los datos de direcciones: aplique la geocodificación en las canalizaciones de datos o los procesos por lotes para estandarizar los datos de direcciones, utilizando el almacenamiento persistente como referencia continua.
-
Determine las zonas horarias: identifique la zona horaria de las ciudades o direcciones para proporcionar marcas horarias precisas para aplicaciones como los viajes, la programación y la facturación.
Comprenda la solicitud
La solicitud acepta parámetros opcionales, comoAdditionalFeatures, y BiasPositionFilter, para refinar los resultados de la búsqueda. Las opciones adicionales, como LanguageMaxResults, yPoliticalView, proporcionan una mayor personalización de la respuesta. El parámetro obligatorio esQuery, que puede proporcionarse como texto de formato libre o estructurado comoQueryComponents. Para obtener más información, consulte la referencia de la API de geocodificación.
La solicitud incluye los siguientes parámetros clave:
- Autenticación
-
Para la autenticación, el
Keyparámetro es opcional si se utilizan otros métodos.-
Key: parámetro opcional para la autenticación.
Para obtener más información, consulte Autenticarse con Amazon Location Service
-
- Consultas y sesgos
-
Parámetros utilizados para la consulta y el sesgo geográfico de los resultados.
-
QueryText: consulta de texto de formato libre para buscar ubicaciones. -
QueryComponents: componentes estructurados como el número de dirección, el país, la localidad o el código postal para una búsqueda precisa. -
BiasPosition: Posición geográfica para sesgar los resultados de la búsqueda.
Para obtener más información, consulte Consultas y sesgos
-
- Refinando los resultados
-
Aplique filtros para refinar los resultados.
-
Filter: filtra para incluir países o tipos de lugares específicos. Para obtener más información, consulte Filtrado.
-
- Internacionalización y localización
-
Especifique el idioma y aplique una visión política para obtener resultados localizados.
-
Language: 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 información adicional, como los detalles de la zona horaria.
-
AdditionalFeatures: Opción para solicitar detalles adicionales, como la zona horaria. Para obtener más información, consulte Características adicionales.
-
Comprenda la respuesta
La respuesta proporcionaResultItems, que contienen datos de ubicación detalladosAddress, como PlaceIdPosition, y otros atributos relevantes. También se pueden incluir características adicionales, como TimeZone información o MatchScores para cada componente de la consulta. Cada uno ResultItem representa una ubicación coincidente o un resultado de geocodificación en función de los parámetros de solicitud especificados. Para obtener más información, consulta la referencia de la API de geocodificación.
La respuesta incluye los siguientes parámetros clave:
- Dirección y detalles relacionados
-
Detalles sobre la ubicación devuelta, incluidos los componentes de la dirección.
-
Address: dirección completa, incluidos el país, la región, el código postal y los detalles de la calle. -
PostalCodeDetails: Información adicional relacionada con los códigos postales. -
StreetComponents: Detalles de la calle, incluidos el nombre y el tipo de base.
-
- Tipos y categorías de lugares
-
Información sobre el tipo y la categoría del lugar devuelto.
-
Categories: Lista de categorías que describen el lugar, por ejemplo, restaurantes o escuelas. -
PlaceType: Especifica el tipo de lugar, como la ciudad, la dirección o la región.
-
- Análisis de resultados
-
Puntuaciones que indican en qué medida coinciden los resultados con la consulta de entrada.
-
MatchScores: Puntuaciones para igualar la precisión.-
Overall: mide el grado de coincidencia de una búsqueda de direcciones con los datos introducidos, en una escala del 0,0 al 1,0 (del 0% al 100%). Una puntuación perfecta de 1,0 significa que todas las partes de la búsqueda se encontraron en la base de datos. Es normal obtener puntuaciones más bajas cuando se incluyen detalles adicionales, como nombres de contacto o instrucciones de entrega. Naturalmente, esto reduce la puntuación, pero no significa necesariamente que la dirección sea incorrecta. -
Component Score: Cada componente de la dirección (comoAddressNumberoPostalCode) se puntúa individualmente en una escala del 0,0 al 1,0 (del 0% al 100%). Estas puntuaciones indican la precisión con la que cada parte de la dirección coincide con el resultado. Por ejemplo, siAddressNumberStreet, y obtiene unaPostalCodepuntuación cercana a 1,0, puede confiar en la coincidencia incluso si la puntuación general es inferior debido a otros detalles de la consulta.
nota
Si no aparece ninguna puntuación para un componente específico (por ejemplo
Street), ese componente se cuenta como 0. Esto ayuda a identificar las partes de la dirección que podrían necesitar verificación.Este sistema de puntuación ayuda a equilibrar las coincidencias exactas y la facilidad de uso cuando se trata de búsquedas de direcciones reales que suelen incluir información adicional.
-
-
- Detalles adicionales
-
Incluye información adicional relacionada con la ubicación según sea necesario.
-
AccessPoints: Coordenadas geográficas que representan los puntos de acceso. -
TimeZone: Información de zona horaria de la ubicación.
-
