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á.
Pesquisar texto
Pesquisar texto permite que você consulte dados de localização usando uma única entrada de texto de formato livre, retornando os resultados do local com filtros opcionais, como país, círculo geográfico ou caixa delimitadora. A API também permite a pesquisa por QueryId retornada da API de sugestão. A resposta inclui detalhes como nome do local, endereço, telefone, categoria, tipo de alimento, informações de contato e horário de funcionamento. Atributos opcionais, como fonemas, fusos horários e muito mais, também estão disponíveis com base em parâmetros especificados.
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 sobre os custos associados aos resultados armazenados.
Para obter mais informações, consulte SearchTexta Amazon Location Service API Reference.
Para obter exemplos de solicitações, respostas, comandos cURL e CLI para essa API, consulte Como usar Pesquisar texto.
Casos de uso
-
Pesquisa de bairros por texto: ajude os clientes a localizar o local relevante mais próximo. Os clientes podem encontrar o endereço, a empresa ou a atração mais próxima, como museus, lojas ou parques.
-
Descoberta de negócios: permita que os usuários encontrem empresas ou tipos de locais específicos inserindo palavras-chave como “restaurante italiano” ou “cafeteria”. Esse atributo é particularmente útil para aplicações de entrega de comida ou recomendação de restaurantes.
-
Colocar a pesquisa em aplicações de viagens: permita que os usuários pesquisem locais, pontos turísticos ou empresas usando texto de formato livre, como “hotéis próximos à Torre Eiffel”, para receber sugestões relevantes rapidamente.
-
Pesquisa de instituições educacionais: permita que os usuários pesquisem escolas, faculdades ou centros de treinamento (por exemplo, “escolas primárias” ou “universidades”), uma ferramenta útil para pais ou alunos.
Sobre a solicitação
A solicitação da API Pesquisar texto permite que vários parâmetros refinem a pesquisa. Os parâmetros opcionais ativam atributos adicionais, distorção de localização, critérios de filtragem, preferências de idioma e limites de resultados. Para obter mais detalhes, consulte a Referência da API de Pesquisar texto.
A solicitação inclui 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
-
Parâmetros usados para especificar a pesquisa de texto e o desvio de localização.
-
QueryText: texto de formato livre para pesquisar locais. -
QueryId: permite a conclusão das consultas sugeridas pela API de sugestão. -
BiasPosition: prioriza os resultados próximos a uma longitude e latitude específicas.
Para obter mais informações, consulte Consulta e desvios.
-
- Refinar resultados
-
Filtra os resultados para restringir os critérios de pesquisa.
-
Filter: permite filtrar por caixa delimitadora ou área circular para limitar os resultados da pesquisa.
Consulte mais detalhes em Filtrar.
-
- 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 extras, como informações de fuso horário.
-
AdditionalFeatures: opção para solicitar detalhes adicionais, como fuso horário.
Para obter mais informações, consulte Recursos adicionais.
-
Sobre a resposta
A resposta da API Pesquisar texto fornece resultados detalhados que correspondem à consulta, com informações sobre localização, detalhes de endereço, cadeia de negócios, contatos, fonemas, fuso horário e horário de funcionamento. Para obter mais detalhes, consulte a Referência da API de Pesquisar texto.
A resposta inclui os seguintes dados principais:
- Endereço e detalhes relacionados
-
Informações abrangentes de endereço do local retornado.
-
Address: inclui país, rua e outros detalhes de endereço.
-
- Tipos e categorias de locais
-
Descreve o tipo e a categoria do local.
-
Categories: uma lista de categorias que descrevem o local, como Restaurantes e Escolas. -
PlaceType: especifica o tipo de local, como cidade, endereço ou região. -
BusinessChains: indica todas as cadeias de negócios associadas.
-
- Detalhes adicionais
-
Informações adicionais relacionadas ao local, conforme solicitado.
-
Contacts: fornece e-mails, números de telefone e sites. -
OpeningHours: horário de funcionamento do local. -
AccessPoints: coordenadas geográficas associadas ao local. -
Phonemes: representações fonéticas dos componentes do endereço. -
TimeZone: informações de fuso horário, incluindo diferenças.
-
