Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Scegli un percorso utilizzando Suggest e la possibilità di evidenziare i termini di ricerca corrispondenti
Con l'API Suggest, ricevi suggerimenti di completamento automatico in tempo reale man mano che gli utenti digitano le loro query di ricerca per luoghi o categorie. I risultati vengono classificati in base alla pertinenza, con le corrispondenze più probabili che appaiono per prime. La risposta dell'API include informazioni di evidenziazione che mostrano in che modo ogni suggerimento corrisponde alla query dell'utente.
Casi d'uso potenziali
Usa l'evidenziazione per mostrare agli utenti quali parti di ogni suggerimento corrispondono ai loro input, semplificando la selezione rapida del risultato desiderato.
Esempi
Quando si mostra l'elenco dei risultati agli utenti, è possibile utilizzare i campi Highlights della risposta per aiutare l'utente a identificare in che modo l'input è stato abbinato ai risultati. Nell'esempio seguente, l'utente esegue una query per «Effel tow». Ciò corrisponde a un risultato con il titolo «Tour Eiffel (Torre Eiffel)». Utilizzando il campo dei risultati Highlights, è possibile modificare lo stile del risultato in modo da mostrare dove la query di input è stata abbinata all'output, con il risultato che il testo viene mostrato all'utente come «Tour Eiffel (Torre Eiffel)».
Questo esempio dimostra come utilizzare l'API Suggest per cercare un punto di interesse con errori di ortografia.
- 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"
Suggerimenti per gli sviluppatori
Visualizza i risultati della ricerca utilizzando il campo di Title risposta per fornire agli utenti voci concise e riconoscibili. Per risultati che potrebbero sembrare simili, utilizza il Place.Address.Label campo per mostrare dettagli aggiuntivi sull'indirizzo che aiutano gli utenti a distinguerli. Per ulteriori informazioni, consulta Come aiutare gli utenti a distinguere tra risultati simili.
