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](places-pricing.md) para implicaciones de los costos asociados a los resultados almacenados. Para obtener más información, consulta [ReverseGeocode](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html)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](https://docs.aws.amazon.com/location/latest/developerguide/reverse-geocode-how-to.html). ## 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 **nota** En el caso de los clientes que estén en `ap-southeast-1` y`ap-southeast-5`, los campos de solicitud y respuesta admitidos pueden diferir. Consulta la [referencia de la ReverseGeocode API](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html) para obtener más información. 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 `Key` es 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](access.md). **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](places-querying-biasing.md). **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, consulte [Filtrado](places-filtering.md). **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](places-localization-internationalization.md). **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](additional-features.md). ## 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.