As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Como pesquisar usando o nome da categoria ou o tipo de alimento
A API `SearchText` permite pesquisar pelo nome da categoria, como restaurantes, escolas e muito mais. Você também pode pesquisar por tipo de alimento.
Uma forma de usar a SearchText API é permitir que os usuários finais pesquisem por nome (categoria e tipo de alimento) e pela posição tendenciosa do conjunto de aplicativos. Essas posições de desvio podem ser a posição do dispositivo, posição de IP, ou um centro da janela do mapa. Além disso, os usuários finais podem informar o nome da cidade ou do local, e a aplicação pode desviar os resultados com base nas coordenadas geográficas.
Para obter mais informações, consulte [Filtros de categorias](places-filtering.md#place-categories) e [Filtros de Tipo de comida](places-filtering.md#food-type).
## Casos de uso possíveis
+ Pesquisar um ponto de interesse ou local específico como parte da exploração de um bairro.
+ Pesquisar um ponto turístico específico para o planejamento de viagens.
+ Procurar restaurantes que sirvam um prato específico.
## Exemplos
### Pesquisar em uma categoria
------
#### [ 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
```
------
### Pesquisar em um tipo de alimento
Especifique um tipo de alimento para `QueryText` para selecionar restaurantes por tipo de alimento. A filtragem por tipo de alimento permite indexar, consultar e exibir os 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
```
------