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
O GetPlace recupera informações detalhadas sobre um local usando uma PlaceId exclusiva. 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 para obter detalhes de custo associados aos resultados armazenados.
Para obter mais informações, consulte GetPlace na Referência de API do Amazon Location Service.
Por exemplo, solicitações, respostas, comandos cURL e CLI para essa API, consulte Como usar GetPlace.
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 API GetPlace para atualizar detalhes sobre empresas e locais, de forma 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.
-
Recuperar detalhes do local após sugestões de digitação antecipada: melhore a experiência do usuário integrando a API GetPlace com atributos de preenchimento automático ou sugestão. À medida que os usuários digitam um endereço, nome de empresa ou ponto de interesse, as sugestões trazem locais relevantes, e o GetPlace permite o acesso a informações mais detalhadas após a seleção.
Sobre a solicitação
A solicitação da API GetPlace exige parâmetros específicos, como PlaceId, e aceita parâmetros opcionais para atributos adicionais ou traduçã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 de API GetPlace.
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.
-
- 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.
-
- 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.
-
- Recursos adicionais do
-
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.
-
Sobre a resposta
A resposta da API GetPlace inclui dados básicos, como endereço, coordenadas e detalhes da empresa, 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 de API GetPlace.
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.
-
