本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 如何使用类别名称或食物类型进行搜索
`SearchText` API 支持按类别名称（例如餐厅、学校等）进行搜索。您还可以按食物类型进行搜索。
使用 SearchText API 的一种方法是让最终用户按名称（类别和食物类型）和应用程序集的偏见位置进行搜索。这些偏差位置可以是设备位置、IP 位置或地图的视口中心。此外，最终用户可以提供城市名称或地点，应用程序则可以根据地理坐标对结果进行偏置。
有关更多信息，请参阅[类别筛选条件](places-filtering.md#place-categories)和[食物类型筛选条件](places-filtering.md#food-type)。
## 潜在使用案例
+ 探索邻域时，搜索特定的 POI 或地点。
+ 搜索特定的旅游景点，以便进行旅行规划。
+ 搜索供应特定食物的餐厅。
## 示例
### 按类别搜索
------
#### [ 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
```
------
### 按食物类型搜索
为 `QueryText` 指定食物类型，以便按食物类型选择餐厅。通过按食物类型进行筛选，即可按食物类型对餐厅进行索引、查询和展示。
------
#### [ 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
```
------