Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Cómo buscar sitios cercanos mediante el contexto geoespacial
La SearchNearby API le permite explorar lugares cercanos y, al mismo tiempo, restringir los resultados dentro del contexto geoespacial (como un círculo o un cuadro delimitador).
La SearchNearby API te permite filtrar los resultados mediante contextos geoespaciales, como círculos y cuadros delimitadores. Al definir estos límites geográficos, puede limitar los resultados de la búsqueda a áreas específicas.
Casos de uso potenciales
-
Limitación de los resultados de la búsqueda a un área geográfica específica
-
Búsqueda dentro de los límites definidos de forma personalizada
-
Centrarse en los resultados en los barrios o distritos específicos
Ejemplos
En el siguiente ejemplo se muestra cómo buscar escuelas dentro de un radio de 1000 metros de las coordenadas especificadas.
- Sample request
-
Esta solicitud busca escuelas en un radio de 1000 metros (1 kilómetro).
{
"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/search-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"]}'
Consejos de desarrolladores
