Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Elija una ruta con Suggest y la posibilidad de resaltar los términos de consulta coincidentes
Con la API Suggest, recibes sugerencias autocompletadas en tiempo real a medida que los usuarios escriben sus consultas de búsqueda para lugares o categorías. Los resultados se clasifican por relevancia, y las coincidencias más probables aparecen primero. La respuesta de la API incluye información destacada que muestra cómo cada sugerencia coincide con la consulta del usuario.
Casos de uso potenciales
Usa el resaltado para mostrar a los usuarios qué partes de cada sugerencia coinciden con sus entradas, lo que facilita la selección rápida del resultado deseado.
Ejemplos
Al mostrar la lista de resultados a los usuarios, los campos destacados de la respuesta se pueden usar para ayudar al usuario a identificar cómo se ha comparado la entrada con los resultados. En el siguiente ejemplo, el usuario realiza una consulta para «Effel tow». Esto hace coincidir un resultado con el título «Tour Eiffel (Torre Eiffel)». Al usar el campo de resultados Highlights, se puede diseñar el resultado para mostrar si la consulta de entrada coincidió con la salida, lo que da como resultado que el texto se muestre al usuario como «Tour Eiffel (Torre Eiffel)».
En este ejemplo, se muestra cómo utilizar la API Suggest para buscar un punto de interés mal escrito.
- 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"
Consejos para desarrolladores
Muestre los resultados de la búsqueda mediante el campo de Title respuesta para proporcionar a los usuarios entradas concisas y reconocibles. Para obtener resultados similares, usa el Place.Address.Label campo para mostrar detalles de dirección adicionales que ayuden a los usuarios a distinguirlos. Para obtener más información, consulte Cómo ayudar a los usuarios a eliminar la ambigüedad entre resultados similares.
