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.
Comment obtenir des résultats pour une requête partiellement dactylographiée ou mal orthographiée
L'API Suggest permet aux applications de répondre aux requêtes des utilisateurs concernant des lieux ou des catégories de résultats. Ces résultats sont triés des correspondances les plus probables aux correspondances les moins probables, ce qui permet à l'API de résoudre les mots incomplets ou mal orthographiés.
Cas d'utilisation potentiels
Exemples
- 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, 5 Avenue Anatole France, 75007 Paris, France",
"Country": {"Code2": "FR", "Code3": "FRA", "Name": "France"},
"Region": {"Code": "IDF", "Name": "Île-de-France"},
"SubRegion": {"Name": "Paris"},
"Locality": "Paris",
"District": "7e Arrondissement",
"PostalCode": "75007",
"Street": "Avenue Anatole France",
"StreetComponents": [{"BaseName": "Anatole France", "Type": "Avenue", "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"}]}
}
],
"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": 1000, "Center": [2.3431932014695382, 48.858844492141145]}, "IncludeCountries": ["FRA"]}' \
--additional-features "Core"
Conseils aux développeurs
Utilisez des filtres tels que Filter.IncludeCountries ou Filter.BoundingBox avecBiasPosition. Ces filtres peuvent aider à affiner les résultats possibles et à améliorer la précision.
{
"QueryText": "Effel tow",
"BiasPosition": [2.2982750966095398, 48.856078089325294],
"Filter": {"IncludeCountries": ["FRA"]}
}