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.
# GetPlace
GetPlace recupera información detallada sobre un lugar utilizando sus características únicas`PlaceId`. La solicitud admite parámetros opcionales para características adicionales, como los datos de la zona horaria o los fonemas, y la localización del idioma. La API devuelve información como la dirección, las coordenadas, los detalles de la empresa, los métodos de contacto y la información de la zona horaria.
**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 detalles de los costos asociados a los resultados almacenados.
Para obtener más información, consulta [GetPlace](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html)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 utilizarlos](https://docs.aws.amazon.com/location/latest/developerguide/get-place-how-to.html). GetPlace
## Casos de uso
+ **Actualice los datos almacenados:** actualice periódicamente los datos almacenados para garantizar que la aplicación proporcione información precisa y actualizada. Usa la GetPlace API para actualizar los detalles de las empresas y los lugares, asegurándote de que los usuarios dispongan de la información más reciente. Por ejemplo, actualice los horarios de apertura, los datos de contacto y las opiniones de los usuarios de los restaurantes o tiendas locales para aumentar la confianza de los usuarios y la funcionalidad de la aplicación.
+ **Recupera los detalles de los sitios después de recibir sugerencias de mecanografía:** mejora la experiencia del usuario integrando la GetPlace API con funciones de autocompletado o sugerencias. A medida que los usuarios escriben una dirección, un nombre comercial o un punto de interés, las sugerencias proporcionan lugares relevantes y GetPlace permiten acceder a información más detallada una vez realizada la selección.
## Explicación de la solicitud
**nota**
En `ap-southeast-1` el caso de los clientes`ap-southeast-5`, los campos de solicitud y respuesta admitidos pueden diferir. Consulta la [referencia de la GetPlace API](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html) para obtener más información.
La solicitud de GetPlace API requiere parámetros específicos, como el`PlaceId`, y admite parámetros opcionales para funciones adicionales o para la localización de idiomas. Estos parámetros ayudan a personalizar los resultados en función del idioma, el uso previsto y el contexto geográfico. Para obtener más información, consulta la referencia de la GetPlace API.
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`: clave de la API para la autorización.
Para obtener más información, consulte [Autenticación con Amazon Location Service](access.md).
**Consultas**
Define el identificador único para recuperar la información del lugar.
+ `PlaceId`: el identificador único para el lugar (obligatorio).
Para obtener más información, consulte [Consultas y sesgos](places-querying-biasing.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 detalles de la zona horaria.
+ `AdditionalFeatures`: opción para solicitar información adicional, como detalles sobre la zona horaria o fonemas.
Para obtener más información, consulte [Características adicionales](additional-features.md).
## Explicación de la respuesta
La respuesta de la GetPlace API incluye datos básicos, como la dirección, las coordenadas y los detalles de la empresa, así como datos adicionales basados en los parámetros de la solicitud. También se puede proporcionar información como las restricciones de acceso, las zonas horarias y los detalles de los fonemas para la pronunciación. Para obtener más información, consulta la referencia de la GetPlace API.
La respuesta incluye los datos de claves siguientes:
**Dirección y detalles relacionados**
Proporciona los detalles completos de la dirección de la ubicación.
+ `Address`: información de la dirección completa que incluye el país, la región y el código postal.
+ `PostalCodeDetails`: información adicional sobre los códigos postales y las autoridades.
**Tipos y categorías de lugares**
Describe el tipo y la categoría del lugar.
+ `BusinessChains`: información sobre cualquier cadena empresarial asociada.
+ `Categories`: categorías a las que pertenece el lugar, como alimentos o venta minorista.
+ `PlaceType`: tipo de lugar, como un punto de interés o una localidad.
**Detalles adicionales**
Proporciona datos adicionales sobre el lugar, tal como se especifica en la solicitud.
+ `Contacts`: métodos de contacto, incluidos números de teléfono, correos electrónicos y sitios web.
+ `OpeningHours`: horario comercial u horario de acceso.
+ `AccessPoints`: coordenadas geográficas (longitud y latitud) de los puntos de acceso.
+ `Phonemes`: pronunciaciones para varios componentes de direcciones.
+ `TimeZone`: información de zona horaria, incluida la desviación.