Come cercare un posto all'interno di un paese - Servizio di posizione Amazon

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Come cercare un posto all'interno di un paese

L'SearchTextAPI consente di limitare i risultati della ricerca a uno o più paesi. Questa funzione è utile per effettuare ricerche nelle aree di confine o nei paesi più piccoli vicini tra loro.

Un modo per utilizzare l' SearchText API consiste nel consentire agli utenti finali di effettuare una ricerca a testo libero e di orientare la posizione di un set di applicazioni. Queste posizioni di polarizzazione possono essere la posizione del dispositivo, la posizione IP o il centro di visualizzazione di una mappa. Inoltre, gli utenti finali possono fornire il nome o il luogo della città e l'applicazione può modificare i risultati in base alle coordinate geografiche.

Casi d'uso potenziali

  • Limita i risultati della ricerca all'interno di un paese per un'area con un confine internazionale nelle vicinanze.

  • Filtra i risultati in base a più paesi.

Esempi

In questo esempio, la posizione di polarizzazione è vicino al confine tra Stati Uniti e Canada. Senza specificareIncludeCountries": ["CAN"], l'API restituirebbe risultati sia dal Canada che dagli Stati Uniti.

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