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](places-pricing.md) para obter detalhes sobre os custos associados aos resultados armazenados.
Para obter mais informações, consulte [SearchText](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchText.html)a *Amazon Location Service API Reference*.
Para obter exemplos de solicitações, respostas, comandos cURL e CLI para essa API, consulte [Como usar Pesquisar texto](https://docs.aws.amazon.com/location/latest/developerguide/search-text-how-to.html).
## 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
**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 SearchText API](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchText.html) para obter detalhes.
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](access.md).
**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](places-querying-biasing.md).
**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](places-filtering.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 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](additional-features.md).
## 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.