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 por el nombre de la categoría o el tipo de alimento
La API `SearchText` le permite buscar por el nombre de una categoría, como restaurantes, escuelas, etc. También puede buscar por tipo de alimento.
Una forma de utilizar la SearchText API es permitir a los usuarios finales buscar por nombre (categoría y tipo de alimento) y por la posición de sesgo de un conjunto de aplicaciones. Estas posiciones de sesgo pueden ser la posición del dispositivo, la posición de la IP o el centro del puerto de visualización de un mapa. Además, los usuarios finales pueden proporcionar el nombre de la ciudad o el lugar y la aplicación puede sesgar los resultados en función de las coordenadas geográficas.
Para obtener más información, consulte [Filtros de categorías](places-filtering.md#place-categories) y [Filtros de tipo de alimentación](places-filtering.md#food-type).
## Casos de uso potenciales
+ Busque un lugar o POI específico como parte de la exploración de un vecindario.
+ Busque un lugar turístico específico para planificar el viaje.
+ Busque restaurantes que sirvan un alimento específico.
## Ejemplos
### Búsqueda en una categoría
------
#### [ Sample request ]
```
{
"QueryText": "Nursing Home",
"BiasPosition": [
-123.11336,
49.26038
],
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Diamond Geriatrics Inc",
"Address": {
"Label": "Diamond Geriatrics Inc, 288 W 8th Ave, Vancouver, BC V5Y 1N5, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Mt Pleasant",
"PostalCode": "V5Y 1N5",
"Street": "W 8th Ave",
"StreetComponents": [
{
"BaseName": "8th",
"Type": "Ave",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "W",
"Language": "en"
}
],
"AddressNumber": "288"
},
"Position": [
-123.11061,
49.2636
],
"Distance": 410,
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home",
"LocalizedName": "Nursing Home",
"Primary": true
},
{
"Id": "social_service",
"Name": "Social Service",
"LocalizedName": "Social Services",
"Primary": false
}
]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Para Med Home Health Care",
"Address": {
"Label": "Para Med Home Health Care, 601 W Broadway, Vancouver, BC V5Z 4C2, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Fairview",
"PostalCode": "V5Z 4C2",
"Street": "W Broadway",
"StreetComponents": [
{
"BaseName": "Broadway",
"Prefix": "W",
"Language": "en"
}
],
"AddressNumber": "601"
},
"Position": [
-123.11772,
49.26343
],
"Distance": 464,
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home",
"LocalizedName": "Nursing Home",
"Primary": true
},
{
"Id": "hospital_or_health_care_facility",
"Name": "Hospital or Health Care Facility",
"LocalizedName": "Hospital or Health Care Facility",
"Primary": false
}
]
}
...
...
]
}
```
------
#### [ 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": "Nursing Home",
"BiasPosition": [
-123.11336,
49.26038
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Nursing Home" --bias-position -123.11336 49.26038
```
------
### Búsqueda en un tipo de alimento
Especifique un tipo de alimento para `QueryText` para seleccionar restaurantes por tipo de comida. Filtrar por tipo de alimento permite indexar, consultar y mostrar los restaurantes por tipo de alimento.
------
#### [ Sample request ]
```
{
"QueryText": "Sushi",
"BiasPosition": [
-123.11336,
49.26038
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Sushi Tomy",
"Address": {
"Label": "Sushi Tomy, 555 W 12th Ave, Vancouver, BC V5Z 3X7, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Fairview",
"PostalCode": "V5Z 3X7",
"Street": "W 12th Ave",
"StreetComponents": [
{
"BaseName": "12th",
"Type": "Ave",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "W",
"Language": "en"
}
],
"AddressNumber": "555"
},
"Position": [
-123.11629,
49.26086
],
"Distance": 219,
"Categories": [
{
"Id": "deli",
"Name": "Deli",
"LocalizedName": "Deli",
"Primary": true
},
{
"Id": "restaurant",
"Name": "Restaurant",
"LocalizedName": "Restaurant",
"Primary": false
},
{
"Id": "casual_dining",
"Name": "Casual Dining",
"LocalizedName": "Casual Dining",
"Primary": false
}
],
"FoodTypes": [
{
"LocalizedName": "Japanese - Sushi",
"Id": "japanese-sushi",
"Primary": true
},
{
"LocalizedName": "Canadian",
"Id": "canadian",
"Primary": false
},
{
"LocalizedName": "Japanese",
"Id": "japanese",
"Primary": false
}
]
},
{
"PlaceId": ""
"PlaceType": "PointOfInterest",
"Title": "Shiro Japanese Restaurant",
"Address": {
"Label": "Shiro Japanese Restaurant, 3096 Cambie St, Vancouver, BC V5Z 2V9, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Mt Pleasant",
"PostalCode": "V5Z 2V9",
"Street": "Cambie St",
"StreetComponents": [
{
"BaseName": "Cambie",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "3096"
},
"Position": [
-123.11461,
49.25797
],
"Distance": 283,
"Categories": [
{
"Id": "casual_dining",
"Name": "Casual Dining",
"LocalizedName": "Casual Dining",
"Primary": true
},
{
"Id": "restaurant",
"Name": "Restaurant",
"LocalizedName": "Restaurant",
"Primary": false
}
],
"FoodTypes": [
{
"LocalizedName": "Japanese - Sushi",
"Id": "japanese-sushi",
"Primary": true
},
{
"LocalizedName": "Asian",
"Id": "asian",
"Primary": false
},
{
"LocalizedName": "Japanese",
"Id": "japanese",
"Primary": false
}
]
},
...
...
]
}
```
------
#### [ 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": "Sushi",
"BiasPosition": [
-123.11336,
49.26038
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Sushi" --bias-position -123.11336 49.26038
```
------