Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Wählen Sie eine Route mithilfe von Suggest und der Möglichkeit, übereinstimmende Abfragebegriffe hervorzuheben
Mit der Suggest-API erhalten Sie Vorschläge zur automatischen Vervollständigung in Echtzeit, wenn Benutzer ihre Suchanfragen für Orte oder Kategorien eingeben. Die Ergebnisse werden nach Relevanz geordnet, wobei die wahrscheinlichsten Treffer zuerst angezeigt werden. Die API-Antwort enthält hervorgehobene Informationen, aus denen hervorgeht, wie jeder Vorschlag mit der Anfrage des Benutzers übereinstimmt.
Mögliche Anwendungsfälle
Verwenden Sie die Hervorhebung, um Benutzern zu zeigen, welche Teile der einzelnen Vorschläge zu ihren Eingaben passen, sodass sie schneller das gewünschte Ergebnis auswählen können.
Beispiele
Bei der Anzeige der Ergebnisliste für Benutzer können die Highlights-Felder in der Antwort verwendet werden, damit der Benutzer erkennen kann, wie die Eingabe mit den Ergebnissen abgeglichen wurde. Im folgenden Beispiel stellt der Benutzer eine Abfrage nach „Effel tow“. Dies entspricht einem Ergebnis mit dem Titel „Tour Eiffel (Eiffelturm)“. Mithilfe des Highlights-Ergebnisfeldes kann das Ergebnis so gestaltet werden, dass es zeigt, wo die Eingabeabfrage mit der Ausgabe abgeglichen wurde, was dazu führt, dass der Text dem Benutzer als „Eiffelturm (Eiffelturm)“ angezeigt wird.
Dieses Beispiel zeigt, wie Sie die Suggest-API verwenden, um nach einer falsch geschriebenen Sehenswürdigkeit zu suchen.
- 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"
Tipps für Entwickler
Zeigen Sie die Suchergebnisse mithilfe des Title Antwortfeldes an, um Benutzern präzise, wiedererkennbare Einträge zu bieten. Verwenden Sie für Ergebnisse, die möglicherweise ähnlich aussehen, das Place.Address.Label Feld, um zusätzliche Adressdetails anzuzeigen, die Benutzern helfen, sie voneinander zu unterscheiden. Weitere Informationen finden Sie unter So helfen Sie Benutzern, zwischen ähnlichen Ergebnissen zu unterscheiden.
