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.
# Verwenden Sie Suggest und die Möglichkeit, nach einer Region oder einem Land zu filtern
Die Suggest-API ermöglicht das Ausfüllen von Abfragen nach Orten oder Ergebniskategorien. Die Ergebnisse sind nach Treffern mit der wahrscheinlichsten und der unwahrscheinlichsten sortiert. Darüber hinaus können Sie die Ergebnisse weiter nach bestimmten Regionen oder Ländern filtern.
## Mögliche Anwendungsfälle
+ **Ergebnisse filtern:** Wenn Sie eine Suche durchführen, können Sie nach Land oder nur nach der Region filtern, in der Ihr Unternehmen tätig ist.
## Beispiele
Durch das Hinzufügen eines Filters nach Ländern wird sichergestellt, dass Sie nur die relevantesten Ergebnisse erhalten. Verwenden Sie Filter. IncludeCountries dafür.
### Ermöglichen Sie Benutzern, nach Ländern zu filtern
------
#### [ Sample request ]
```
{
"QueryText": "hote",
"BiasPosition": [
2.2982750966095398, 48.856078089325294
],
"Filter": {
"IncludeCountries": [
"FRA"
]
},
"AdditionalFeatures": [
"Core"
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"Title": "Hôtel de Matignon (Hôtel Matignon)",
"SuggestResultItemType": "Place",
"Place": {
"PlaceId": "Redacted",
"PlaceType": "PointOfInterest",
"Address": {
"Label": "Hôtel de Matignon, 57 Rue de Varenne, 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": "Rue de Varenne",
"StreetComponents": [
{
"BaseName": "Varenne",
"Type": "Rue de",
"TypePlacement": "BeforeBaseName",
"TypeSeparator": " ",
"Language": "fr"
}
],
"AddressNumber": "57"
},
"Position": [
2.32072,
48.85471
],
"Distance": 1650,
"Categories": [
{
"Id": "tourist_attraction",
"Name": "Tourist Attraction",
"LocalizedName": "Attraction touristique",
"Primary": true
},
{
"Id": "landmark-attraction",
"Name": "Landmark-Attraction",
"LocalizedName": "Lieu d'intérêt/Attraction",
"Primary": false
},
{
"Id": "historical_monument",
"Name": "Historical Monument",
"LocalizedName": "Monument historique",
"Primary": false
},
{
"Id": "residential_area-building",
"Name": "Residential Area-Building",
"LocalizedName": "Bâtiment résidentiel",
"Primary": false
}
]
},
"Highlights": {
"Title": [
{
"StartIndex": 0,
"EndIndex": 4,
"Value": "Hôt"
},
{
"StartIndex": 19,
"EndIndex": 23,
"Value": "(Hô"
}
],
"Address": {
"Label": [
{
"StartIndex": 0,
"EndIndex": 4,
"Value": "Hôt"
}
]
}
}
},
...
{
"Title": "Hotel",
"SuggestResultItemType": "Query",
"Query": {
"QueryId": "Redacted",
"QueryType": "Category"
},
"Highlights": {
"Title": [
{
"StartIndex": 0,
"EndIndex": 4,
"Value": "Hote"
}
]
}
},
...
],
"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": "hote",
"BiasPosition": [
2.2982750966095398, 48.856078089325294
],
"Filter": {
"IncludeCountries": [
"FRA"
]
},
"AdditionalFeatures": [
"Core"
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places suggest --key ${YourKey} \
--query-text "hote" \
--bias-position 2.2982750966095398 48.856078089325294 \
--filter '{"IncludeCountries": ["FRA"]}' \
--additional-features "Core"
```
------
Wenn Sie eine filter-by-region Suchoption hinzufügen, werden nur die Ergebnisse angezeigt, die in die angegebene Region passen. Dies wird verwendet, um den Umfang der Suche auf die Region zu beschränken, die Ihr Unternehmen betrifft. Das folgende Beispiel zeigt, wie eine falsch geschriebene Suche nach Marriott-Hotels in der Nähe von Boston mit einigen Hotelergebnissen und einer Folgeabfrage abgeschlossen wird.
## Ermöglichen Sie Benutzern, nach Regionen zu filtern
------
#### [ Sample request ]
```
{
"QueryText": "Mariot",
"Filter": {
"IncludeCountries": [
"USA"
],
"BoundingBox": [
-71.15693983012913,42.261623506672635,
-70.97249727163558,42.37584075627763
]
},
"AdditionalFeatures": [
"Core"
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"Title": "Boston Marriott Copley Place",
"SuggestResultItemType": "Place",
"Place": {
"PlaceId": "Redacted",
"PlaceType": "PointOfInterest",
"Address": {
"Label": "Boston Marriott Copley Place, 110 Huntington Ave, Boston, MA 02116, United States",
"Country": {
"Code2": "US",
"Code3": "USA",
"Name": "United States"
},
"Region": {
"Code": "MA",
"Name": "Massachusetts"
},
"SubRegion": {
"Name": "Suffolk"
},
"Locality": "Boston",
"District": "Back Bay",
"PostalCode": "02116",
"Street": "Huntington Ave",
"StreetComponents": [
{
"BaseName": "Huntington",
"Type": "Ave",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "110"
},
"Position": [
-71.07769,
42.34726
],
"Distance": 3347,
"Categories": [
{
"Id": "hotel",
"Name": "Hotel",
"LocalizedName": "Hotel",
"Primary": true
}
],
"BusinessChains": [
{
"Name": "Marriott",
"Id": "Marriott"
}
],
"AccessPoints": [
{
"Position": [
-71.07922,
42.34665
]
}
]
},
"Highlights": {
"Title": [
{
"StartIndex": 7,
"EndIndex": 14,
"Value": "Marriot"
}
],
"Address": {
"Label": [
{
"StartIndex": 7,
"EndIndex": 14,
"Value": "Marriot"
}
]
}
}
},
...
{
"Title": "Marriott",
"SuggestResultItemType": "Query",
"Query": {
"QueryId": "Redacted",
"QueryType": "BusinessChain"
},
"Highlights": {
"Title": [
{
"StartIndex": 0,
"EndIndex": 8,
"Value": "Marriott"
}
]
}
},
...
],
"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": "Mariot",
"Filter": {
"IncludeCountries": [
"USA"
],
"BoundingBox": [
-71.15693983012913,42.261623506672635,
-70.97249727163558,42.37584075627763
]
},
"AdditionalFeatures": [
"Core"
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places suggest --key ${YourKey} \
--query-text "hote" \
--filter '{"IncludeCountries": ["FRA"], "BoundingBox": [ -71.15693983012913,42.261623506672635, -70.97249727163558,42.37584075627763]}' \
--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, zwischen ihnen zu unterscheiden. Weitere Informationen finden Sie unter [So helfen Sie Benutzern, zwischen ähnlichen Ergebnissen zu unterscheidenVerwenden Sie die Suggest-API, um die Ergebnisse eindeutig zu definieren](suggest-disambiguate-results.md).