So suchen Sie nach einem Ort in einem Land - Amazon Location Service

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.

So suchen Sie nach einem Ort in einem Land

Mit der SearchText API können Sie die Suchergebnisse auf ein oder mehrere Länder beschränken. Diese Funktion ist nützlich für die Suche in Grenzgebieten oder kleineren Ländern, die aneinander grenzen.

Eine Möglichkeit, die SearchText API zu verwenden, besteht darin, Endbenutzern die Möglichkeit zu geben, eine Freitextsuche durchzuführen und dabei die Voreingenommenheit einer Anwendungsgruppe zu berücksichtigen. Bei diesen Fehlstellungen kann es sich um eine Geräteposition, eine IP-Position oder den Mittelpunkt des Kartenansichtsfensters handeln. Darüber hinaus können Endbenutzer den Namen oder den Ort der Stadt angeben, und die Anwendung kann die Ergebnisse anhand von Geokoordinaten verzerren.

Mögliche Anwendungsfälle

  • Beschränken Sie die Suchergebnisse auf ein Gebiet innerhalb eines Landes, das in der Nähe eine internationale Grenze hat.

  • Filtern Sie die Ergebnisse auf mehrere Länder.

Beispiele

In diesem Beispiel befindet sich die Bias-Position in der Nähe der Grenze zwischen den USA und Kanada. Ohne Angabe IncludeCountries": ["CAN"] würde die API Ergebnisse sowohl aus Kanada als auch aus den USA zurückgeben.

Sample request
{ "QueryText": "Starbucks", "BiasPosition": [ -122.741803, 49.002478 ] }
Sample response
{ "ResultItems": [ { "PlaceId": "<Redacted>", "PlaceType": "PointOfInterest", "Title": "STARBUCKS", "Address": { "Label": "STARBUCKS, 16010 24 Ave, Surrey, BC V3Z 0R5, Canada", "Country": { "Code2": "CA", "Code3": "CAN", "Name": "Canada" }, "Region": { "Code": "BC", "Name": "British Columbia" }, "SubRegion": { "Name": "Metro Vancouver" }, "Locality": "Surrey", "District": "South Surrey", "PostalCode": "V3Z 0R5", "Street": "24 Ave", "StreetComponents": [ { "BaseName": "24", "Type": "Ave", "TypePlacement": "AfterBaseName", "TypeSeparator": " ", "Language": "en" } ], "AddressNumber": "16010" }, "Position": [ -122.77867, 49.04482 ], "Distance": 5422, "Categories": [ { "Id": "coffee_shop", "Name": "Coffee Shop", "LocalizedName": "Coffee Shop", "Primary": true } ] }, { "PlaceId": "<Redacted>", "PlaceType": "PointOfInterest", "Title": "STARBUCKS", "Address": { "Label": "STARBUCKS, 1730 152 St, Surrey, BC V4A 4N4, Canada", "Country": { "Code2": "CA", "Code3": "CAN", "Name": "Canada" }, "Region": { "Code": "BC", "Name": "British Columbia" }, "SubRegion": { "Name": "Metro Vancouver" }, "Locality": "Surrey", "District": "South Surrey", "PostalCode": "V4A 4N4", "Street": "152 St", "StreetComponents": [ { "BaseName": "152", "Type": "St", "TypePlacement": "AfterBaseName", "TypeSeparator": " ", "Language": "en" } ], "AddressNumber": "1730" }, "Position": [ -122.80096, 49.03341 ], "Distance": 5517, "Categories": [ { "Id": "coffee_shop", "Name": "Coffee Shop", "LocalizedName": "Coffee Shop", "Primary": true } ], "BusinessChains": [ { "Name": "Starbucks", "Id": "Starbucks" } ] }, ... ... ] }
cURL
curl --request POST \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-text?key=Your_Key' \ --header 'Content-Type: application/json' \ --data '{ "QueryText": "Starbucks", "BiasPosition": [ -122.741803, 49.002478 ] }'
AWS CLI
aws geo-places search-text --key ${YourKey} --query-text "Starbucks" --bias-position -122.741803 49.002478