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é à l'aide du contexte géospatial
L' SearchNearby API vous permet d'explorer les environs, tout en limitant les résultats dans un contexte géospatial (tel qu'un cercle ou un cadre de délimitation).
L' SearchNearby API vous permet de filtrer les résultats à l'aide de contextes géospatiaux tels que des cercles et des cadres de délimitation. En définissant ces limites géographiques, vous pouvez limiter les résultats de recherche à des zones spécifiques.
Cas d'utilisation potentiels
-
Limiter les résultats de recherche à une zone géographique spécifique
-
Effectuez des recherches dans des limites définies sur mesure
-
Concentrez les résultats sur des quartiers ou districts ciblés
Exemples
L'exemple suivant montre comment rechercher des écoles dans un rayon de 1 000 mètres autour des coordonnées spécifiées.
- Sample request
-
Cette demande recherche des écoles dans un rayon de 1 000 mètres (1 kilomètre).
{
"QueryPosition": [
-122.741803,
49.002478
],
"QueryRadius":1000,
"Filter" : {
"IncludeCategories": ["school"]
}
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "PointOfInterest",
"Title": "Grace Lutheran Church",
"Address": {
"Label": "Grace Lutheran Church, 702 G St, Blaine, WA 98230-5125, United States",
"Country": {
"Code2": "US",
"Code3": "USA",
"Name": "United States"
},
"Region": {
"Code": "WA",
"Name": "Washington"
},
"SubRegion": {
"Name": "Whatcom"
},
"Locality": "Blaine",
"PostalCode": "98230-5125",
"Street": "G St",
"StreetComponents": [
{
"BaseName": "G",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "702"
},
"Position": [
-122.74157,
48.99533
],
"Distance": 795,
"Categories": [
{
"Id": "church",
"Name": "Church",
"LocalizedName": "Church",
"Primary": true
},
{
"Id": "kindergarten_and_childcare",
"Name": "Kindergarten and Childcare",
"LocalizedName": "Kindergarten & Childcare",
"Primary": false
},
{
"Id": "school",
"Name": "School",
"LocalizedName": "School",
"Primary": false
}
]
}
...
]
}
- cURL
-
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/searearch-nearby?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryPosition": [
-122.741803,
49.002478
],
"QueryRadius": 1000,
"Filter": {
"IncludeCategories": ["school"]
}
}'
- AWS CLI
-
aws geo-places search-nearby --key ${YourKey} \
--query-position -122.741803 49.002478 \
--query-radius 1000 \
--filter '{"IncludeCategories": ["school"]}'
Conseils aux développeurs
