As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# GetPlace
GetPlace recupera informações detalhadas sobre um local usando seu exclusivo`PlaceId`. A solicitação aceita parâmetros opcionais para atributos adicionais, como dados de fuso horário ou fonemas e tradução de idiomas. A API retorna informações como endereço, coordenadas, detalhes da empresa, métodos de contato e informações de fuso horário.
**nota**
Se os resultados forem armazenados, eles serão cobrados no nível mais alto de preço de armazenamento. Use o parâmetro `IntendedUse` para especificar se os resultados são para uso único ou armazenamento. Consulte [Preços de locais](places-pricing.md) para obter detalhes de custo associados aos resultados armazenados.
Para obter mais informações, consulte [GetPlace](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html)a *Amazon Location Service API Reference*.
[Por exemplo, solicitações, respostas, comandos cURL e CLI para essa API, consulte Como usar. GetPlace](https://docs.aws.amazon.com/location/latest/developerguide/get-place-how-to.html)
## Casos de uso
+ **Atualizar dados armazenados:** atualize regularmente os dados armazenados para que a aplicação forneça informações precisas e atuais. Use a GetPlace API para atualizar detalhes sobre empresas e locais, garantindo que os usuários tenham as informações mais recentes. Por exemplo, atualize o horário de funcionamento, detalhes de contato e avaliações de usuários para restaurantes ou lojas locais para aumentar a confiança do usuário e a funcionalidade da aplicação.
+ **Recupere os detalhes do local após as sugestões de digitação antecipada:** melhore a experiência do usuário integrando a GetPlace API aos recursos de preenchimento automático ou sugestão. Conforme os usuários digitam um endereço, nome comercial ou ponto de interesse, as sugestões fornecem locais relevantes e GetPlace permitem o acesso a informações mais detalhadas após a seleção.
## Sobre a solicitação
**nota**
Para clientes em `ap-southeast-1` e`ap-southeast-5`, os campos de solicitação e resposta compatíveis podem ser diferentes. Consulte a [Referência da GetPlace API](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html) para obter detalhes.
A solicitação da GetPlace API exige parâmetros específicos, como o`PlaceId`, e oferece suporte a parâmetros opcionais para recursos adicionais ou localização de idiomas. Esses parâmetros ajudam a personalizar os resultados com base no idioma, no uso pretendido e no contexto geográfico. Para obter mais detalhes, consulte a Referência GetPlace da API.
A solicitação aceita os seguintes parâmetros principais:
**Autenticação**
O parâmetro `Key` é opcional quando outros métodos de autenticação são usados.
+ `Key`: chave de API para autorização.
Para obter mais informações, consulte [Autenticação com o Amazon Location Service](access.md).
**Consultas**
Define o identificador exclusivo para recuperar as informações do local.
+ `PlaceId`: (obrigatório) o identificador exclusivo para o local.
Para obter mais informações, consulte [Consulta e desvios](places-querying-biasing.md).
**Internacionalização e localização**
Opções para personalizar o idioma e aplicar uma visão política aos resultados.
+ `Language`: especifica o idioma dos resultados.
+ `PoliticalView`: aplica uma visão política que reflete reivindicações territoriais.
Para obter mais informações, consulte [Localização e internacionalização](places-localization-internationalization.md).
**Atributos adicionais**
Solicita dados adicionais, como detalhes do fuso horário.
+ `AdditionalFeatures`: opção para solicitar informações adicionais, como fuso horário ou detalhes do fonema.
Para obter mais informações, consulte [Recursos adicionais](additional-features.md).
## Sobre a resposta
A resposta da GetPlace API inclui dados básicos, como endereço, coordenadas e detalhes comerciais, além de dados adicionais com base nos parâmetros da solicitação. Informações como restrições de acesso, fusos horários e detalhes do fonema para pronúncia também podem ser fornecidas. Para obter mais detalhes, consulte a Referência GetPlace da API.
A resposta inclui os seguintes dados principais:
**Endereço e detalhes relacionados**
Fornece detalhes completos do endereço do local.
+ `Address`: informações completas de endereço, incluindo país, região e código postal.
+ `PostalCodeDetails`: informações adicionais sobre códigos postais e autoridades.
**Tipos e categorias de locais**
Descreve o tipo e a categoria do local.
+ `BusinessChains`: informações sobre todas as redes de negócios associadas.
+ `Categories`: categorias às quais o local pertence, como alimentos ou varejo.
+ `PlaceType`: tipo do local, como ponto de interesse ou localidade.
**Detalhes adicionais**
Fornece dados adicionais sobre o local, conforme especificado na solicitação.
+ `Contacts`: métodos de contato, incluindo números de telefone, e-mails e sites.
+ `OpeningHours`: horário comercial ou horários de acesso.
+ `AccessPoints`: coordenadas geográficas (longitude e latitude) dos pontos de acesso.
+ `Phonemes`: pronúncias para vários componentes do endereço.
+ `TimeZone`: informações de fuso horário, incluindo diferenças.