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 utilizar SearchNearby
Esta sección contiene una variedad de guías prácticas y ejemplos sobre cómo usar SearchNearby.
**Topics**
+ [Cómo buscar sitios cercanos desde una posición](how-to-search-nearby.md)
+ [Cómo buscar sitios cercanos en función de la categoría](how-to-search-nearby-category.md)
+ [Cómo buscar sitios cercanos en función del tipo de alimento](how-to-search-nearby-food.md)
+ [Cómo buscar sitios cercanos en función de la cadena empresarial](how-to-search-nearby-business.md)
+ [Cómo buscar sitios cercanos en un país](how-to-search-nearby-country.md)
+ [Cómo buscar sitios cercanos mediante el contexto geoespacial](how-to-search-nearby-geospatial.md)
# Cómo buscar sitios cercanos desde una posición
La SearchNearby API permite consultar todos los lugares y puntos de interés (POI) cercanos sin introducir ningún texto específico. Los usuarios pueden explorar barrios POIs, descubrir y mucho más con esta API. Requiere una `QueryPosition`, que puede representar la ubicación de un dispositivo, la posición basada en IP o el centro de la ventana gráfica del mapa. Otra opción, los usuarios pueden especificar una ciudad o lugar para sesgar los resultados en función de las coordenadas geográficas de esa ubicación.
## Casos de uso potenciales
+ **Explora los alrededores POIs:** consulta todos los puntos de interés cercanos a la posición actual.
+ **Explore lugares cercanos:** consulte todas las ubicaciones o lugares cercanos a una posición determinada.
## Ejemplos
### Búsqueda de sitios cercanos desde una posición
En este ejemplo, la búsqueda se realiza desde una posición en Dubái con una latitud 25.26951 y una longitud 55.30884.
------
#### [ Sample request ]
```
{
"QueryPosition": [
55.30884,
25.26951
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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": "",
"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
```
------
# Cómo buscar sitios cercanos en función de la categoría
La SearchNearby API permite consultar puntos de interés (POI) con la inclusión o exclusión de categorías específicas. Esto puede ayudar a los usuarios a explorar barrios, descubrir lugares locales y POIs mucho más. La API requiere una `QueryPosition`, que se puede basar en la ubicación del dispositivo, la posición de la IP o el centro de la ventana gráfica del mapa. Otra opción, los usuarios pueden especificar una ciudad o un lugar y la aplicación sesgará los resultados en función de las coordenadas de esa ubicación.
Para obtener más información sobre las categorías compatibles, consulte [Filtros de categorías](places-filtering.md#place-categories).
## Casos de uso potenciales
+ **Explore las instalaciones locales:** busque las instalaciones disponibles en un vecindario.
+ **Detecte las atracciones turísticas:** identifique los puntos turísticos dentro de una ciudad.
+ **Planifique viajes en una ciudad:** organice viajes por diferentes ciudades POIs dentro de una ciudad elegida.
## Ejemplos
### Inclusión de categoría
------
#### [ Sample request ]
```
{
"QueryPosition": [
4.35609,
50.84439
],
"Filter": {
"IncludeCategories": ["airport"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Brussels Airport",
"Address": {
"Label": "Brussels Airport, A201, 1930 Zaventem, België",
"Country": {
"Code2": "BE",
"Code3": "BEL",
"Name": "België"
},
"Region": {
"Code": "VLG",
"Name": "Vlaanderen"
},
"SubRegion": {
"Name": "Vlaams Brabant"
},
"Locality": "Zaventem",
"PostalCode": "1930",
"Street": "A201",
"StreetComponents": [
{
"BaseName": "A201",
"Language": "nl"
}
]
},
"Position": [
4.47767,
50.89452
],
"Distance": 10191,
"Categories": [
{
"Id": "airport",
"Name": "Airport",
"LocalizedName": "Luchthaven",
"Primary": true
}
]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Internationale Luchthaven Antwerpen",
"Address": {
"Label": "Internationale Luchthaven Antwerpen, Luchthavenlei 1, 2100 Antwerpen, België",
"Country": {
"Code2": "BE",
"Code3": "BEL",
"Name": "België"
},
"Region": {
"Code": "VLG",
"Name": "Vlaanderen"
},
"SubRegion": {
"Name": "Antwerpen"
},
"Locality": "Antwerpen",
"District": "Deurne",
"PostalCode": "2100",
"Street": "Luchthavenlei",
"StreetComponents": [
{
"BaseName": "Luchthaven",
"Type": "lei",
"TypePlacement": "AfterBaseName",
"TypeSeparator": "",
"Language": "nl"
}
],
"AddressNumber": "1"
},
"Position": [
4.45083,
51.18867
],
"Distance": 38852,
"Categories": [
{
"Id": "airport",
"Name": "Airport",
"LocalizedName": "Luchthaven",
"Primary": true
}
]
}
]
}
```
------
#### [ 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": [
4.35609,
50.84439
],
"Filter": {
"IncludeCategories": ["airport"]
},
"MaxResults": 2
}
```
------
#### [ AWS CLI ]
```
aws geo-places search-nearby --key ${YourKey} \
--query-position 4.35609 50.84439 \
--filter '{"IncludeCategories": ["airport"]}' \
--max-results 2
```
------
### Exclusión de categoría
------
#### [ Sample request ]
```
{
"QueryPosition": [
4.35609,
50.84439
],
"Filter": {
"ExcludeCategories": ["airport"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Socialbrands Module 2",
"Address": {
"Label": "Socialbrands Module 2, Albertinaplein, 1000 Brussel, België",
"Country": {
"Code2": "BE",
"Code3": "BEL",
"Name": "België"
},
"Region": {
"Code": "BRU",
"Name": "Brussel"
},
"SubRegion": {
"Name": "Brussel"
},
"Locality": "Brussel",
"District": "Koningswijk",
"PostalCode": "1000",
"Street": "Albertinaplein",
"StreetComponents": [
{
"BaseName": "Albertina",
"Type": "plein",
"TypePlacement": "AfterBaseName",
"TypeSeparator": "",
"Language": "nl"
}
]
},
"Position": [
4.35609,
50.84439
],
"Distance": 0,
"Categories": [
{
"Id": "commercial_services",
"Name": "Commercial Services",
"LocalizedName": "Commerciële diensten",
"Primary": true
}
],
"Contacts": {
"Websites": [
{
"Value": "https://oneread.net"
}
]
},
"AccessPoints": [
{
"Position": [
4.35609,
50.84439
]
}
]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Barman Privé",
"Address": {
"Label": "Barman Privé, Albertinaplein, 1000 Brussel, België",
"Country": {
"Code2": "BE",
"Code3": "BEL",
"Name": "België"
},
"Region": {
"Code": "BRU",
"Name": "Brussel"
},
"SubRegion": {
"Name": "Brussel"
},
"Locality": "Brussel",
"District": "Koningswijk",
"PostalCode": "1000",
"Street": "Albertinaplein",
"StreetComponents": [
{
"BaseName": "Albertina",
"Type": "plein",
"TypePlacement": "AfterBaseName",
"TypeSeparator": "",
"Language": "nl"
}
]
},
"Position": [
4.35609,
50.84439
],
"Distance": 0,
"Categories": [
{
"Id": "catering_and_other_food_services",
"Name": "Catering and Other Food Services",
"LocalizedName": "Catering- en horecadiensten",
"Primary": true
}
],
"Contacts": {
"Phones": [
{
"Value": "+32476891634"
}
]
},
"OpeningHours": [
{
"Display": [
"ma-zo: 00:00 - 24:00"
],
"OpenNow": true,
"Components": [
{
"OpenTime": "T000000",
"OpenDuration": "PT24H00M",
"Recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH,FR,SA,SU"
}
]
}
],
"AccessPoints": [
{
"Position": [
4.35609,
50.84439
]
}
]
}
]
}
```
------
#### [ 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": [
4.35609,
50.84439
],
"Filter": {
"ExcludeCategories": ["airport"]
}
}
```
------
#### [ AWS CLI ]
```
aws geo-places search-nearby --key ${YourKey} \
--query-position 4.35609 50.84439 \
--filter '{"ExcludeCategories": ["airport"]}' \
--max-results 2
```
------
# Cómo buscar sitios cercanos en función del tipo de alimento
La API de `SearchNearby` le permite consultar restaurantes cercanos que sirven un tipo de alimento específico. También puede excluir los tipos de alimentos de los resultados.
Puede utilizar la SearchNearby API para permitir a los usuarios finales explorar barrios y descubrir lugares de interés. La API lo requiere QueryPosition, que puede ser la posición del dispositivo, la posición de la IP o el centro de un puerto con vista en un mapa. Otra forma es permitir a los usuarios finales proporcionar el nombre de la ciudad o el nombre del lugar y la aplicación puede sesgar los resultados en función de las coordenadas geográficas.
Para obtener más información sobre los tipos de alimentos, consulte [Filtros de tipo de alimentación](places-filtering.md#food-type).
## Casos de uso potenciales
+ Explore los tipos de alimentos disponibles en los alrededores.
+ Excluya las opciones de restaurantes que sirven tipos de alimentos a los que es alérgico.
## Ejemplo
### Búsqueda de sitios cercanos por tipo de alimento
En el siguiente ejemplo, se muestra cómo buscar lugares cercanos en función del tipo de alimento.
------
#### [ Sample request ]
Esta solicitud busca restaurantes que sirvan comida china cerca de las coordenadas especificadas.
```
{
"QueryPosition": [
12.49563,
41.90325
],
"Filter": {
"IncludeFoodTypes": ["chinese"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Bufala e Pachino",
"Address": {
"Label": "Bufala e Pachino, Via Firenze, 53, 00184 Roma RM, Italia",
"Country": {
"Code2": "IT",
"Code3": "ITA",
"Name": "Italia"
}
},
"Position": [
12.49409,
41.90237
],
"Distance": 161,
"Categories": [
{
"Id": "restaurant",
"Name": "Restaurant",
"LocalizedName": "Ristorante",
"Primary": true
}
],
"FoodTypes": [
{
"LocalizedName": "Pizza",
"Id": "pizza",
"Primary": true
},
{
"LocalizedName": "Cinese",
"Id": "chinese",
"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": [12.49563, 41.90325],
"Filter": {
"IncludeFoodTypes": ["chinese"]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-nearby --key ${YourKey} \
--query-position 12.49563 41.90325 \
--filter '{"IncludeFoodTypes": ["chinese"]}'
```
------
### Consejos de desarrolladores
+ Puede utilizar `ExludeFoodTypes` para excluir determinadas cadenas empresariales de los resultados.
+ Puede excluir o incluir varios tipos de alimentos.
# Cómo buscar sitios cercanos en función de la cadena empresarial
La SearchNearby API le permite consultar cadenas comerciales cercanas. Puede incluir o excluir cadenas empresariales específicas en la búsqueda. Esta característica permite a los usuarios finales explorar barrios, detectar puntos de interés, etc.
Para usar la SearchNearby API, debes proporcionar una QueryPosition, que puede ser:
+ Una posición del dispositivo
+ Una posición basada en IP
+ El centro de la ventana gráfica de un mapa
Otra opción, los usuarios pueden proporcionar un nombre de ciudad o lugar y la aplicación puede sesgar los resultados en función de las coordenadas geográficas de esa ubicación.
Para obtener más información sobre las cadenas empresariales compatibles, consulte [Filtro de cadenas empresariales](places-filtering.md#business-chains).
## Casos de uso potenciales
+ Exploración de las empresas de los alrededores
+ Expansión de la empresa al encontrar clientes B2B cercanos
## Ejemplos
### Búsqueda de sitios cercanos por cadena empresarial
En el siguiente ejemplo, se muestra cómo buscar ubicaciones de Starbucks cercanas.
------
#### [ Sample request ]
Esta solicitud busca ubicaciones de Starbucks cercanas a las coordenadas especificadas.
```
{
"QueryPosition": [
12.49563,
41.90325
],
"Filter" : {
"IncludeBusinessChains": ["Starbucks"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Starbucks",
"Address": {
"Label": "Starbucks, Via Giovanni Giolitti, 2, 00185 Roma RM, Italia",
"Country": {
"Code2": "IT",
"Code3": "ITA",
"Name": "Italia"
},
"Region": {
"Name": "Lazio"
},
"SubRegion": {
"Code": "RM",
"Name": "Roma"
},
"Locality": "Roma",
"District": "Esquilino",
"PostalCode": "00185",
"Street": "Via Giovanni Giolitti",
"StreetComponents": [
{
"BaseName": "Giovanni Giolitti",
"Type": "Via",
"TypePlacement": "BeforeBaseName",
"TypeSeparator": " ",
"Language": "it"
}
],
"AddressNumber": "2"
},
"Position": [
12.50102,
41.90093
],
"Distance": 515,
"Categories": [
{
"Id": "coffee_shop",
"Name": "Coffee Shop",
"LocalizedName": "Bar",
"Primary": true
}
],
"BusinessChains": [
{
"Name": "Starbucks",
"Id": "Starbucks"
}
]
}
]
}
```
------
#### [ 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": [
12.49563,
41.90325
],
"Filter" : {
"IncludeBusinessChains": ["Starbucks"]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-nearby --key ${YourKey} \
--query-position 12.49563 41.90325 \
--filter '{"IncludeBusinessChains": ["Starbucks"]}'
```
------
## Consejos de desarrolladores
+ Puede utilizar `ExcludeBusinessChains` para excluir determinadas cadenas empresariales de los resultados.
+ Puede excluir o incluir varias cadenas empresariales.
# Cómo buscar sitios cercanos en un país
La SearchNearby API te permite buscar lugares cercanos dentro de un país específico. Para usar la API, debes proporcionar una QueryPosition, que puede ser:
+ Una posición del dispositivo
+ Una posición basada en IP
+ El centro de la ventana gráfica de un mapa
Otra opción, los usuarios pueden proporcionar un nombre de ciudad o lugar y la aplicación puede sesgar los resultados en función de las coordenadas geográficas de esa ubicación.
## Casos de uso potenciales
+ Exploración de las empresas dentro de un país
+ Búsqueda de clientes B2B cercanos dentro de un país
+ Exploración de lugares turísticos dentro de un país
## Ejemplos
### Búsqueda de campos de golf en Canadá
En el siguiente ejemplo, se muestra cómo buscar campos de golf dentro de Canadá cerca de coordenadas específicas.
------
#### [ Sample request ]
Esta solicitud busca campos de golf en Canadá cerca de la ubicación especificada.
```
{
"QueryPosition": [
-122.741803,
49.002478
],
"Filter" : {
"IncludeCategories": ["golf_course"],
"IncludeCountries": ["CAN"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Peace Portal Golf Course",
"Address": {
"Label": "Peace Portal Golf Course, 16900 * Ave, Surrey, BC V*Z *P*, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Surrey",
"District": "South Surrey",
"PostalCode": "V*Z *P*",
"Street": "* Ave",
"StreetComponents": [
{
"BaseName": "4",
"Type": "Ave",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "16900"
},
"Position": [
-122.75086,
49.00921
],
"Distance": 998,
"Categories": [
{
"Id": "golf_course",
"Name": "Golf Course",
"LocalizedName": "Golf Course",
"Primary": true
}
],
"Contacts": {
"Phones": [
{
"Value": "+16045384818" }
],
"Websites": [
{
"Value": "http://www.peaceportalgolf.com"
}
]
},
"AccessPoints": [
{
"Position": [
-122.75087,
49.00935
]
}
]
}
]
}
```
------
#### [ 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
],
"Filter" : {
"IncludeCategories": ["golf_course"],
"IncludeCountries": ["CAN"]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-nearby --key ${YourKey} \
--query-position -122.741803 49.002478 \
--filter '{"IncludeCategories": ["golf_course"], "IncludeCountries": ["CAN"]}'
```
------
# 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
### Búsqueda mediante el radio de consulta
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": "",
"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
+ Otra opción, puede utilizar un filtro de cuadro delimitador.