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á.
Sugestão
A sugestão fornece previsões ou recomendações com base no contexto ou na entrada do usuário, como locais relevantes, pontos de interesse, termos de consulta ou categorias de pesquisa. Ela ajuda os usuários a encontrar locais, pontos de interesse ou identificar consultas de acompanhamento com base em entradas incompletas ou com erros ortográficos. A API retorna uma lista de possíveis correspondências ou refinamentos, que podem ser usados para formular uma consulta mais precisa. Os usuários podem selecionar a sugestão apropriada para pesquisas futuras. A API suporta a filtragem de resultados por localização e outros atributos e oferece atributos adicionais, como fonemas e fusos horários. A resposta inclui termos de consulta refinados e informações detalhadas sobre o local.
nota
Por padrão, a API de sugestão retorna somente os campos ID e Title, oferecendo uma opção econômica. É possível solicitar componentes de endereço e destaques adicionais com a configuração de additionalFeatures como Core. Consulte Preços de locais para entender as implicações de custo dos resultados armazenados.
Para obter mais informações, consulte Suggest na Referência de API do Amazon Location Service.
Por exemplo, solicitações, respostas, comandos cURL e CLI para essa API, consulte Como usar a sugestão.
Casos de uso
-
Serviços de transporte por aplicativo: fornecem sugestões em tempo real para preencher rapidamente os endereços dos locais de coleta e entrega, garantindo precisão e agilidade na reserva de viagens.
-
Serviços de viagem e navegação: oferecem previsões em tempo real para locais ou pontos turísticos, mesmo para termos com erros ortográficos ou parcialmente inseridos, como “Eifel” para “Torre Eiffel”. A API refina as sugestões para oferecer pontos de interesse relevantes nas proximidades, ajudando os usuários a localizar locais com precisão.
-
Assistência na pesquisa de restaurantes: antecipa os interesses dos usuários em restaurantes e indica opções de refeições nas proximidades, aprimorando a experiência de pesquisa.
Sobre a solicitação
A solicitação da API de sugestão usa parâmetros para gerar sugestões com base na entrada do usuário. Os parâmetros opcionais permitem resultados de pesquisa refinados usando critérios de filtragem e desvios de localização. Para obter mais detalhes, consulte a Referência de API de sugestão.
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
-
Define a pesquisa de texto livre e o desvio de localização.
-
QueryText: texto em formato livre para gerar sugestões. (obrigatório) -
BiasPosition: prioriza as sugestões próximas 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
-
- Limitação de resultados
-
Define limites para o número de resultados ou refinamentos de consulta retornados.
-
MaxQueryRefinements: limita o número de termos de refinamento da consulta retornados. -
MaxResults: limita o número de sugestões retornadas.
-
Sobre a resposta
A resposta fornece endereços ou locais sugeridos com base na consulta de entrada, com atributos como localização, detalhes do endereço, redes comerciais, contatos, fonemas, fuso horário e horário de funcionamento. A API retorna ResultItems, representando possíveis correspondências para concluir a consulta de entrada. Há dois tipos de resultados, identificados por SuggestResultItemType: resultados do tipo Query sugerem uma categoria de acompanhamento ou uma consulta em cadeia, que podem ser usados para obter resultados focados para uma categoria específica, transmitindo QueryID para a API SearchText. Os resultados do tipo Place fornecem um resultado final com um endereço e informações adicionais sobre o local. Para obter mais detalhes, consulte a Referência de API de sugestão.
A resposta inclui os seguintes dados principais:
- Análise de resultados
-
Fornece informações sobre como refinar a consulta de entrada.
-
QueryRefinements: termos que podem ser usados para refinar a consulta de pesquisa. -
Highlights: destaca partes do endereço ou do título que correspondem à consulta.
-
- Tipos e categorias de locais
-
Descreve o tipo e a categoria do local.
-
Categories: categorias que descrevem o local, por exemplo, 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.
-
- Outros detalhes
-
Fornece dados adicionais sobre o local, conforme especificado na solicitação.
-
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.
-
