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 exclusivoPlaceId. 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 GetPlacea Amazon Location Service API Reference.
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 eap-southeast-5, os campos de solicitação e resposta compatíveis podem ser diferentes. Consulte a Referência da GetPlace API para obter detalhes.
A solicitação da GetPlace API exige parâmetros específicos, como oPlaceId, 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.
-
- 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.
-
- 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.
-
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.
-
