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á.
Escolha uma rota usando Suggest e a capacidade de destacar termos de consulta correspondentes
Com a API Suggest, você recebe sugestões de preenchimento automático em tempo real à medida que os usuários digitam suas consultas de pesquisa por lugares ou categorias. Os resultados são classificados por relevância, com as correspondências mais prováveis aparecendo primeiro. A resposta da API inclui informações de destaque que mostram como cada sugestão corresponde à consulta do usuário.
Casos de uso em potencial
Use o destaque para mostrar aos usuários quais partes de cada sugestão correspondem à entrada, facilitando a seleção rápida do resultado desejado.
Exemplos
Ao exibir a lista de resultados para os usuários, os campos Destaques na resposta podem ser usados para ajudar o usuário a identificar como a entrada foi combinada com os resultados. No exemplo abaixo, o usuário faz uma consulta por “Effel tow”. Isso corresponde a um resultado com o título “Tour Eiffel (Torre Eiffel)”. Usando o campo de resultados de Destaques, o resultado pode ser estilizado para mostrar onde a consulta de entrada correspondeu à saída, resultando na exibição do texto ao usuário como “Tour Eiffel (Torre Eiffel)”.
Este exemplo demonstra como usar a API Suggest para pesquisar um ponto de interesse com ortografia incorreta.
- Sample request
-
{
"QueryText": "Effel tow",
"Filter": {
"Circle": {
"Radius": 10000,
"Center": [
2.3431932014695382, 48.858844492141145
]
},
"IncludeCountries": [
"FRA"
]
},
"AdditionalFeatures": [
"Core"
]
}
- Sample response
-
{
"ResultItems": [
{
"Title": "Tour Eiffel (Eiffel Tower)",
"SuggestResultItemType": "Place",
"Place": {
"PlaceId": "<Redacted>",
"PlaceType": "PointOfInterest",
"Address": {
"Label": "Tour Eiffel, * Avenue Anatole France, ***** Paris, France",
"Country": {
"Code2": "FR",
"Code3": "FRA",
"Name": "France"
},
"Region": {
"Code": "IDF",
"Name": "Île-de-France"
},
"SubRegion": {
"Name": "Paris"
},
"Locality": "Paris",
"District": "*e Arrondissement",
"PostalCode": "*****",
"Street": "Avenue Anatole France",
"StreetComponents": [
{
"BaseName": "Anatole France",
"Type": "Avenue",
"TypePlacement": "BeforeBaseName",
"TypeSeparator": " ",
"Language": "fr"
}
],
"AddressNumber": "5"
},
"Position": [
2.2945,
48.85824
],
"Distance": 3563,
"Categories": [
{
"Id": "historical_monument",
"Name": "Historical Monument",
"LocalizedName": "Monument historique",
"Primary": true
},
{
"Id": "landmark-attraction",
"Name": "Landmark-Attraction",
"LocalizedName": "Lieu d'intérêt/Attraction",
"Primary": false
},
{
"Id": "tourist_attraction",
"Name": "Tourist Attraction",
"LocalizedName": "Attraction touristique",
"Primary": false
},
{
"Id": "sports_complex-stadium",
"Name": "Sports Complex-Stadium",
"LocalizedName": "Stade ou complexe sportif",
"Primary": false
}
]
},
"Highlights": {
"Title": [
{
"StartIndex": 13,
"EndIndex": 23,
"Value": "Eiffel Tow"
}
],
"Address": {}
}
}
],
"QueryRefinements": []
}
- cURL
-
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/suggest?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryText": "Effel tow",
"Filter": {
"Circle": {
"Radius": 10000,
"Center": [
2.3431932014695382, 48.858844492141145
]
},
"IncludeCountries": [
"FRA"
]
},
"AdditionalFeatures": [
"Core"
]
}'
- AWS CLI
-
aws geo-places suggest --key ${YourKey} \
--query-text "Effel tow" \
--filter '{"Circle": {"Radius": 10000, "Center": [2.3431932014695382, 48.858844492141145]}, "IncludeCountries": ["FRA"]}' \
--additional-features "Core"
Dicas para desenvolvedores
Exiba os resultados da pesquisa usando o campo de Title resposta para fornecer aos usuários entradas concisas e reconhecíveis. Para resultados que possam parecer semelhantes, use o Place.Address.Label campo para mostrar detalhes adicionais do endereço que ajudem os usuários a distingui-los. Para obter mais informações, consulte Como ajudar os usuários a eliminar a ambiguidade entre resultados semelhantes.
