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
La geocodificación transforma las direcciones textuales o los nombres de los 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 características 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 parámetro IntendedUse para indicar un solo uso o almacenamiento. Consulte los Precios de lugares para comprender las implicaciones económicas de los resultados almacenados.
Para obtener más información, consulte Geocodificación 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.
Casos de uso
-
Agregue datos adicionales a las direcciones de los clientes: mejore los registros de direcció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 dirección: aplique la geocodificación en las canalizaciones de datos o los procesos por lotes para estandarizar los datos de posición, mediante el uso del 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 acepta parámetros opcionales, como AdditionalFeatures, BiasPosition y Filter, para ajustar los resultados de la búsqueda. Las opciones adicionales, como Language, MaxResults y PoliticalView, proporcionan una mayor personalización de la respuesta. El parámetro obligatorio es Query, que se puede proporcionar como texto de formato libre o estructurado como QueryComponents. Para obtener más información, consulte la referencia de la API de Geocodificación.
La solicitud incluye los siguientes parámetros claves:
- Autenticación
-
Para la autenticación, el parámetro
Keyes opcional si se utilizan otros métodos.-
Key: parámetro opcional para la autenticación.
Para obtener más información, consulte Autenticación 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
-
- Ajuste de los resultados
-
Aplique filtros para ajustar los resultados.
-
Filter: filtre 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 de
-
Solicite información adicional, como detalles sobre la zona horaria.
-
AdditionalFeatures: opción para solicitar datos adicionales, como la zona horaria. Para obtener más información, consulte Características adicionales.
-
Explicación de la respuesta
La respuesta proporciona ResultItems, que contienen datos de ubicación detallados como Address, PlaceId, Position y otros atributos relevantes. También se pueden incluir características adicionales, como información de TimeZone o MatchScores para cada componente de la consulta. Cada 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 detallada, consulte la referencia de la API de Geocodificación.
El resultado incluye los parámetros clave siguientes:
- Dirección y detalles relacionados
-
Detalles sobre la ubicación devuelta, incluidos los componentes de la dirección.
-
Address: dirección completa que incluye 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 sobre la calle, incluidos el nombre y el tipo de la 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, 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
-
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 ingresados, 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, si la puntuación deAddressNumber,StreetyPostalCodese acerca 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.
-
