Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Choisissez un itinéraire à l'aide de Suggest et de la possibilité de mettre en évidence les termes de requête correspondants
Avec l'API Suggest, vous obtenez des suggestions de saisie semi-automatique en temps réel lorsque les utilisateurs saisissent leurs requêtes de recherche pour des lieux ou des catégories. Les résultats sont classés par pertinence, les correspondances les plus probables apparaissant en premier. La réponse de l'API inclut des informations de mise en évidence qui montrent comment chaque suggestion correspond à la requête de l'utilisateur.
Cas d'utilisation potentiels
Utilisez le surlignage pour montrer aux utilisateurs quelles parties de chaque suggestion correspondent à leurs entrées, ce qui leur permet de sélectionner rapidement le résultat souhaité.
Exemples
Lorsque vous affichez la liste des résultats aux utilisateurs, les champs Highlights de la réponse peuvent être utilisés pour aider l'utilisateur à identifier la façon dont l'entrée a été mise en correspondance avec les résultats. Dans l'exemple ci-dessous, l'utilisateur fait une requête pour « Effel tow ». Cela correspond à un résultat avec le titre « Tour Eiffel (Tour Eiffel) ». À l'aide du champ de résultat Highlights, le résultat peut être stylisé pour indiquer où la requête d'entrée a été mise en correspondance avec la sortie, le texte étant alors affiché à l'utilisateur sous la forme « Tour Eiffel (Tour Eiffel er) ».
Cet exemple montre comment utiliser l'API Suggest pour rechercher un point d'intérêt mal orthographié.
- 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"
Conseils aux développeurs
Affichez les résultats de recherche à l'aide du champ de Title réponse pour fournir aux utilisateurs des entrées concises et reconnaissables. Pour obtenir des résultats similaires, utilisez le Place.Address.Label champ pour afficher des informations supplémentaires sur les adresses afin d'aider les utilisateurs à les distinguer. Pour de plus amples informations, veuillez consulter Comment aider les utilisateurs à désambiguïser des résultats similaires.
