Comment effectuer une recherche à proximité à partir d'une position - Amazon Location Service

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 effectuer une recherche à proximité à partir d'une position

L' SearchNearby API permet de rechercher tous les lieux et points d'intérêt (POI) situés à proximité sans saisir de texte spécifique. Les utilisateurs peuvent explorer les quartiers POIs, découvrir et bien plus encore à l'aide de cette API. Cela nécessite unQueryPosition, qui peut représenter l'emplacement d'un appareil, la position basée sur l'IP ou le centre de la fenêtre d'affichage de la carte. Les utilisateurs peuvent également spécifier une ville ou un lieu pour biaiser les résultats en fonction des coordonnées géographiques de cet emplacement.

Cas d'utilisation potentiels

  • Explorez les environs POIs : consultez tous les points d'intérêt situés à proximité de la position actuelle.

  • Explorez les lieux à proximité : Afficher tous les emplacements ou lieux proches d'une position donnée.

Exemples

Dans cet exemple, la recherche est effectuée à partir d'une position à Dubaï située à 25,26951 de latitude et 55,30884 de longitude.

Sample request
{ "QueryPosition": [ 55.30884, 25.26951 ] }
Sample response
{ "ResultItems": [ { "PlaceId": "<Redacted>", "PlaceType": "PointOfInterest", "Title": "هما", "Address": { "Label": "هما, شارع مستشفى آل مكتوم, نايف دبي, الإمارات العربية المتحدة", "Country": { "Code2": "AE", "Code3": "ARE", "Name": "الإمارات العربية المتحدة" }, "SubRegion": { "Name": "دبي" }, "Locality": "دبي", "District": "نايف", "Street": "شارع مستشفى آل مكتوم", "StreetComponents": [ { "BaseName": "مستشفى آل مكتوم", "Type": "شارع", "TypePlacement": "BeforeBaseName", "TypeSeparator": " ", "Language": "ar" } ] }, "Position": [ 55.30884, 25.26951 ], "Distance": 0, "Categories": [ { "Id": "department_store", "Name": "Department Store", "LocalizedName": "مول تجاري", "Primary": true } ], "BusinessChains": [ { "Name": "HEMA", "Id": "HEMA" } ] }, { "PlaceId": "<Redacted>", "PlaceType": "Locality", "Title": "دبي, الإمارات العربية المتحدة", "Address": { "Label": "دبي, الإمارات العربية المتحدة", "Country": { "Code2": "AE", "Code3": "ARE", "Name": "الإمارات العربية المتحدة" }, "SubRegion": { "Name": "دبي" }, "Locality": "دبي" }, "Position": [ 55.30884, 25.26951 ], "Distance": 0, "MapView": [ 54.64906, 24.62308, 55.7371, 25.36995 ] } ] }
cURL
curl --request POST \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \ --header 'Content-Type: application/json' \ --data '{ "QueryPosition": [ 55.30884, 25.26951 ], "MaxResults": 2 }'
AWS CLI
aws geo-places search-nearby --key ${YourKey} \ --query-position 55.30884 25.26951 \ --max-results 2