本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 如何使用 SearchText
本节包含有关如何使用 SearchText API 的各种操作方法指南和示例。
**Topics**
+ [如何使用名称搜索地点、POI 或企业](how-to-search-for-place-poi-business.md)
+ [如何使用联系人信息搜索地点](how-to-search-for-place-using-contact-info.md)
+ [如何使用类别名称或食物类型进行搜索](how-to-search-category-name.md)
+ [如何搜索地址](how-to-search-address.md)
+ [如何在某个国家/地区内搜索地点](how-to-search-place-in-country.md)
+ [如何搜索联系方式和营业时间](how-to-search-opening-hours.md)
+ [如何使用查询 ID 搜索地点](how-to-search-query-id.md)
+ [如何使用特定语言进行搜索](how-to-search-specific-language.md)
# 如何使用名称搜索地点、POI 或企业
该 SearchText API 允许用户使用自由文本输入按名称搜索地点、POI 或企业。设置偏差位置可以对结果进行优化，偏差位置可依据设备位置、IP 位置或地图视口中心来确定。或者，用户可以提供特定的城市或地点，结果会根据用户提供的地理坐标进行偏置。
## 潜在使用案例
+ **按名称定位地点：**根据地名检索位置，例如“煤气镇”。
+ **查找兴趣点 (POIs)：**按名称搜索名胜古迹，例如 “斯坦利公园”。
+ **按企业名称搜索：**按名称定位企业，例如“星巴克”。
## 示例
### 按地名搜索
------
#### [ Sample request ]
```
{
"QueryText": "Gas Town",
"BiasPosition": [
-123.11336,
49.26038
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "District",
"Title": "Gastown, Vancouver, BC, Canada",
"Address": {
"Label": "Gastown, Vancouver, BC, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Gastown",
"PostalCode": "V6B"
},
"Position": [
-123.10647,
49.28363
],
"Distance": 2633,
"MapView": [
-123.11193,
49.28141,
-123.10217,
49.28648
]
}
]
}
```
------
#### [ 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": "Gas Town",
"BiasPosition": [
-123.11336,
49.26038
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Gas Town" --bias-position -123.11336 49.26038
```
------
### 按 POI 名称搜索
------
#### [ Sample request ]
```
{
"QueryText": "Stanley Park",
"BiasPosition": [
-123.11336,
49.26038
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Stanley Park",
"Address": {
"Label": "Stanley Park, Stanley Park Dr, Vancouver, BC V6G, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Stanley Park",
"PostalCode": "V6G",
"Street": "Stanley Park Dr",
"StreetComponents": [
{
"BaseName": "Stanley Park",
"Type": "Dr",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
]
},
"Position": [
-123.13593,
49.29716
],
"Distance": 4405,
"Categories": [
{
"Id": "park-recreation_area",
"Name": "Park-Recreation Area",
"LocalizedName": "Park-Recreation Area",
"Primary": true
},
{
"Id": "tourist_attraction",
"Name": "Tourist Attraction",
"LocalizedName": "Tourist Attraction",
"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": "Stanley Park",
"BiasPosition": [
-123.11336,
49.26038
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Stanley Park" --bias-position -123.11336 49.26038
```
------
### 按企业名称搜索
------
#### [ Sample request ]
```
{
"QueryText": "Amazon YVR11",
"BiasPosition": [
-123.11336,
49.26038
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Amazon YVR11",
"Address": {
"Label": "Amazon YVR11, 510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Downtown Vancouver",
"PostalCode": "V6B 0M3",
"Street": "W Georgia St",
"StreetComponents": [
{
"BaseName": "Georgia",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "W",
"Language": "en"
}
],
"AddressNumber": "510"
},
"Position": [
-123.11694,
49.28126
],
"Distance": 2336,
"Categories": [
{
"Id": "business_facility",
"Name": "Business Facility",
"LocalizedName": "Business Facility",
"Primary": true
}
],
"AccessPoints": [
{
"Position": [
-123.11656,
49.28151
]
}
]
}
]
}
```
------
#### [ 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": "Amazon YVR11",
"BiasPosition": [
-123.11336,
49.26038
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Amazon YVR11" --bias-position -123.11336 49.26038
```
------
# 如何使用联系人信息搜索地点
该 SearchText API 允许用户使用电话号码搜索地点，同时支持国际和本地格式。用户可以对结果进行偏置，方法是根据设备位置、IP 地址或地图视口中心设置一个位置，或者指定一个城市或地点以根据地理坐标来优化结果。
## 潜在使用案例
+ **使用电话号码查找地点：**通过使用联系电话检索地址来查找 POI。
## 示例
### 使用电话号码搜索
在此示例中，使用不列颠哥伦比亚省温哥华的某个偏差位置的电话号码“\$11 778-655-9554”来搜索温哥华水族馆。
------
#### [ Sample request ]
```
{
"QueryText": "+1 778-655-9554",
"BiasPosition": [
-123.11336,
49.26038
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Vancouver Aquarium",
"Address": {
"Label": "Vancouver Aquarium, 834 Avison Way, Vancouver, BC V6G, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Stanley Park",
"PostalCode": "V6G",
"Street": "Avison Way",
"StreetComponents": [
{
"BaseName": "Avison",
"Type": "Way",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "834"
},
"Position": [
-123.13049,
49.30013
],
"Distance": 4591,
"Categories": [
{
"Id": "aquarium",
"Name": "Aquarium",
"LocalizedName": "Aquarium",
"Primary": true
},
{
"Id": "tourist_attraction",
"Name": "Tourist Attraction",
"LocalizedName": "Tourist Attraction",
"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": "+1 778-655-9554",
"BiasPosition": [
-123.11336,
49.26038
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "+1 778-655-9554" --bias-position -123.11336 49.26038
```
------
# 如何使用类别名称或食物类型进行搜索
`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
```
------
# 如何搜索地址
`SearchText` API 支持搜索地址。
使用 SearchText API 的一种方法是让最终用户搜索地址和应用程序集的偏差位置。这些偏差位置可以是设备位置、IP 位置或地图的视口中心。此外，最终用户可以提供城市名称或地点，应用程序则可以根据地理坐标对结果进行偏置。
## 潜在使用案例
+ 根据偏差位置搜索地址。
+ 筛选结果以包含或删除特定地址。
## 示例
### 搜索地址
------
#### [ Sample request ]
```
{
"QueryText":"1368 E 8 Ave Vancouver",
"BiasPosition":[
-123.18544,
49.24643
],
"MaxResults":1
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointAddress",
"Title": "1368 E 8th Ave, Vancouver, BC V5N 1T2, Canada",
"Address": {
"Label": "1368 E 8th Ave, Vancouver, BC V5N 1T2, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Grandview-Woodland",
"PostalCode": "V5N 1T2",
"Street": "E 8th Ave",
"StreetComponents": [
{
"BaseName": "8th",
"Type": "Ave",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "E",
"Language": "en"
}
],
"AddressNumber": "1368"
},
"Position": [
-123.07612,
49.26306
],
"Distance": 8147,
"MapView": [
-123.07752,
49.26299,
-123.05661,
49.26334
]
}
]
}
```
------
#### [ 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": "1368 E 8 Ave Vancouver",
"BiasPosition": [
-123.18544,
49.24643
],
"MaxResults": 1
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "1368 E 8 Ave Vancouver" --bias-position -123.18544 49.24643 --max-results 1
```
------
# 如何在某个国家/地区内搜索地点
通过 `SearchText` API，您可以将搜索结果限制在一个或多个国家/地区内。此功能对于在边境地区或彼此相邻的较小国家/地区进行搜索非常有用。
使用 SearchText API 的一种方法是让最终用户进行自由文本搜索并确定应用程序集的偏见位置。这些偏差位置可以是设备位置、IP 位置或地图的视口中心。此外，最终用户可以提供城市名称或地点，应用程序则可以根据地理坐标对结果进行偏置。
## 潜在使用案例
+ 如果某区域临近国际边境，则将搜索结果限制在一个国家/地区范围内。
+ 筛选结果，以限制在多个国家/地区范围内。
## 示例
### 在某个国家/地区内搜索
在本示例中，偏差位置临近美国和加拿大边境。如果不指定 `IncludeCountries": ["CAN"]`，该 API 将返回来自加拿大和美国的结果。
------
#### [ Sample request ]
```
{
"QueryText": "Starbucks",
"BiasPosition": [
-122.741803,
49.002478
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "STARBUCKS",
"Address": {
"Label": "STARBUCKS, 16010 24 Ave, Surrey, BC V3Z 0R5, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Surrey",
"District": "South Surrey",
"PostalCode": "V3Z 0R5",
"Street": "24 Ave",
"StreetComponents": [
{
"BaseName": "24",
"Type": "Ave",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "16010"
},
"Position": [
-122.77867,
49.04482
],
"Distance": 5422,
"Categories": [
{
"Id": "coffee_shop",
"Name": "Coffee Shop",
"LocalizedName": "Coffee Shop",
"Primary": true
}
]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "STARBUCKS",
"Address": {
"Label": "STARBUCKS, 1730 152 St, Surrey, BC V4A 4N4, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Surrey",
"District": "South Surrey",
"PostalCode": "V4A 4N4",
"Street": "152 St",
"StreetComponents": [
{
"BaseName": "152",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "1730"
},
"Position": [
-122.80096,
49.03341
],
"Distance": 5517,
"Categories": [
{
"Id": "coffee_shop",
"Name": "Coffee Shop",
"LocalizedName": "Coffee Shop",
"Primary": true
}
],
"BusinessChains": [
{
"Name": "Starbucks",
"Id": "Starbucks"
}
]
},
...
...
]
}
```
------
#### [ 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": "Starbucks",
"BiasPosition": [
-122.741803,
49.002478
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Starbucks" --bias-position -122.741803 49.002478
```
------
# 如何搜索联系方式和营业时间
通过 `SearchText` API，您可以搜索 POI（兴趣点）的联系方式和营业时间。
使用该 SearchText API的一种方法是通过搜索公司名称和偏见位置来获取营业地点（电话号码、网站、电子邮件）和营业时间的联系信息。这些偏差位置可以是设备位置、IP 位置或地图的视口中心。另一种方法是让最终用户提供城市名称或地名，应用程序可以根据地理坐标对结果进行偏置。
有关更多信息，请参阅 [联系方式和营业时间](contacts-opening-hours.md)。
## 潜在使用案例
您可以使用 `SearchText` API 根据联系方式和营业时间进行筛选。
## 示例
### 按类别名称搜索
------
#### [ Sample request ]
```
{
"QueryText": "Nursing Home",
"BiasPosition": [
-123.11336,
49.26038
],
"AdditionalFeatures":["Contact"]
}
```
------
#### [ Sample response ]
```
{
"PricingBucket": "Advanced",
"ResultItems": [
{
"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.11771,
49.26341
],
"Distance": 462,
"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
}
],
"Contacts": {
"Phones": [
{
"Value": "+16045634663"
},
{
"Value": "+16047311594",
"Categories": [
{
"Id": "hospital_or_health_care_facility",
"Name": "Hospital or Health Care Facility"
}
]
}
],
"Websites": [
{
"Value": "http://www.rightathomecanada.com/vancouver",
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home"
}
]
},
{
"Value": "https://www.facebook.com/507123162974954",
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home"
}
]
}
]
}
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Yaletown House",
"Address": {
"Label": "Yaletown House, 1099 Cambie St, Vancouver, BC V6B 5A8, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Yaletown",
"PostalCode": "V6B 5A8",
"Street": "Cambie St",
"StreetComponents": [
{
"BaseName": "Cambie",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "1099"
},
"Position": [
-123.11949,
49.27533
],
"Distance": 1721,
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home",
"LocalizedName": "Nursing Home",
"Primary": true
},
{
"Id": "restaurant",
"Name": "Restaurant",
"LocalizedName": "Restaurant",
"Primary": false
},
{
"Id": "clothing_and_accessories",
"Name": "Clothing and Accessories",
"LocalizedName": "Clothing & Accessories",
"Primary": false
},
{
"Id": "market",
"Name": "Market",
"LocalizedName": "Market",
"Primary": false
},
{
"Id": "jeweler",
"Name": "Jeweler",
"LocalizedName": "Jeweler",
"Primary": false
},
{
"Id": "advertising-marketing,_pr_and_market_research",
"Name": "Advertising-Marketing, PR and Market Research",
"LocalizedName": "Advertising/Marketing, PR & Market Research",
"Primary": false
},
{
"Id": "management_and_consulting_services",
"Name": "Management and Consulting Services",
"LocalizedName": "Management and Consulting Services",
"Primary": false
},
{
"Id": "organizations_and_societies",
"Name": "Organizations and Societies",
"LocalizedName": "Organizations and Societies",
"Primary": false
},
{
"Id": "finance_and_insurance",
"Name": "Finance and Insurance",
"LocalizedName": "Finance and Insurance",
"Primary": false
},
{
"Id": "consumer_services",
"Name": "Consumer Services",
"LocalizedName": "Consumer Services",
"Primary": false
},
{
"Id": "attorney",
"Name": "Attorney",
"LocalizedName": "Attorney",
"Primary": false
},
{
"Id": "social_service",
"Name": "Social Service",
"LocalizedName": "Social Services",
"Primary": false
}
],
"Contacts": {
"Phones": [
{
"Value": "+16045584546",
"Categories": [
{
"Id": "management_and_consulting_services",
"Name": "Management and Consulting Services"
},
{
"Id": "consumer_services",
"Name": "Consumer Services"
}
]
},
{
"Value": "+16046464065",
"Categories": [
{
"Id": "finance_and_insurance",
"Name": "Finance and Insurance"
}
]
},
{
"Value": "+16046699800",
"Categories": [
{
"Id": "clothing_and_accessories",
"Name": "Clothing and Accessories"
},
{
"Id": "jeweler",
"Name": "Jeweler"
}
]
},
{
"Value": "+16046838109",
"Categories": [
{
"Id": "attorney",
"Name": "Attorney"
}
]
},
{
"Value": "+16046841838",
"Categories": [
{
"Id": "advertising-marketing,_pr_and_market_research",
"Name": "Advertising-Marketing, PR and Market Research"
},
{
"Id": "management_and_consulting_services",
"Name": "Management and Consulting Services"
}
]
},
{
"Value": "+16046848898",
"Categories": [
{
"Id": "attorney",
"Name": "Attorney"
}
]
},
{
"Value": "+16046890022"
},
{
"Value": "+16046999120",
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home"
}
]
},
{
"Value": "+16046999121",
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home"
}
]
},
{
"Value": "+16048016446",
"Categories": [
{
"Id": "management_and_consulting_services",
"Name": "Management and Consulting Services"
}
]
}
],
"Faxes": [
{
"Value": "+16046464068",
"Categories": [
{
"Id": "finance_and_insurance",
"Name": "Finance and Insurance"
}
]
},
{
"Value": "+16046627954",
"Categories": [
{
"Id": "organizations_and_societies",
"Name": "Organizations and Societies"
}
]
},
{
"Value": "+16046841801",
"Categories": [
{
"Id": "advertising-marketing,_pr_and_market_research",
"Name": "Advertising-Marketing, PR and Market Research"
}
]
},
{
"Value": "+16046848608",
"Categories": [
{
"Id": "attorney",
"Name": "Attorney"
}
]
}
],
"Websites": [
{
"Value": "http://www.yaletown.org",
"Categories": [
{
"Id": "organizations_and_societies",
"Name": "Organizations and Societies"
},
{
"Id": "social_service",
"Name": "Social Service"
},
{
"Id": "nursing_home",
"Name": "Nursing Home"
}
]
},
{
"Value": "http://www.yaletownhq.com",
"Categories": [
{
"Id": "advertising-marketing,_pr_and_market_research",
"Name": "Advertising-Marketing, PR and Market Research"
}
]
},
{
"Value": "http://www.yaletownlaw.ca",
"Categories": [
{
"Id": "attorney",
"Name": "Attorney"
}
]
},
{
"Value": "https://www.facebook.com/1509112252725564",
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home"
}
]
}
],
"Emails": [
{
"Value": "nina@yaletownhq.com",
"Categories": [
{
"Id": "advertising-marketing,_pr_and_market_research",
"Name": "Advertising-Marketing, PR and Market Research"
}
]
}
]
},
"OpeningHours": [
{
"Display": [
"Mon-Fri: 08:30 - 16:00"
],
"OpenNow": true,
"Components": [
{
"OpenTime": "T083000",
"OpenDuration": "PT07H30M",
"Recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH,FR"
}
],
"Categories": [
{
"Id": "organizations_and_societies",
"Name": "Organizations and Societies"
}
]
},
{
"Display": [
"Mon-Fri: 09:00 - 17:00"
],
"OpenNow": true,
"Components": [
{
"OpenTime": "T090000",
"OpenDuration": "PT08H00M",
"Recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH,FR"
}
],
"Categories": [
{
"Id": "attorney",
"Name": "Attorney"
}
]
},
{
"Display": [
"Tue: 10:00 - 16:30",
"Wed-Sat: 09:30 - 16:30"
],
"OpenNow": true,
"Components": [
{
"OpenTime": "T100000",
"OpenDuration": "PT06H30M",
"Recurrence": "FREQ:DAILY;BYDAY:TU"
},
{
"OpenTime": "T093000",
"OpenDuration": "PT07H00M",
"Recurrence": "FREQ:DAILY;BYDAY:WE,TH,FR,SA"
}
],
"Categories": [
{
"Id": "clothing_and_accessories",
"Name": "Clothing and Accessories"
},
{
"Id": "jeweler",
"Name": "Jeweler"
}
]
}
]
},
]
}
```
------
#### [ 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
],
"AdditionalFeatures":["Contact"]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Nursing Home" \
--bias-position -123.11336 49.26038 \
--additional-features "Contact"
```
------
# 如何使用查询 ID 搜索地点
通过 `SearchText` API，您可以获取 [Suggest如何使用建议](suggest.md) 返回的查询结果的详细信息。
## 潜在使用案例
获取查询 ID 的搜索结果，这些结果由 `Suggestion` API 返回。
## 示例
### 按查询 ID 进行搜索
------
#### [ Sample request ]
```
{
"QueryId": ""
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Restore",
"Address": {
"Label": "Restore, 400 Urban Plz, Kirkland, WA 98033, United States",
"Country": {
"Code2": "US",
"Code3": "USA",
"Name": "United States"
},
"Region": {
"Code": "WA",
"Name": "Washington"
},
"SubRegion": {
"Name": "King"
},
"Locality": "Kirkland",
"District": "Moss Bay",
"PostalCode": "98033",
"Street": "Urban Plz",
"StreetComponents": [
{
"BaseName": "Urban",
"Type": "Plz",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "400"
},
"Position": [
-122.19958,
47.67822
],
"Distance": 190670,
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services",
"LocalizedName": "Wellness Center & Services",
"Primary": true
}
],
"BusinessChains": [
{
"Name": "Restore",
"Id": "Restore"
}
],
"Contacts": {
"Phones": [
{
"Value": "+14258352271"
},
{
"Value": "+14254205116"
}
],
"Websites": [
{
"Value": "https://restore.com"
},
{
"Value": "https://restore.com/locations"
},
{
"Value": "https://www.facebook.com/rhwkirkland"
},
{
"Value": "https://www.restore.com/locations/wa-kirkland-wa001?utm_source=extnet&utm_medium=Yext&y_source=1_MzE2Mjk5NTgtNTY2LWxvY2F0aW9uLndlYnNpdGU%3D"
},
{
"Value": "https://www.restore.com/sitemap.xml"
}
],
"Emails": [
{
"Value": "kirkland@restore.com"
}
]
},
"OpeningHours": [
{
"Display": [
"Mon-Thu: 10:00 - 19:00",
"Fri: 10:00 - 17:00",
"Sat: 09:00 - 17:00",
"Sun: 10:00 - 16:00"
],
"OpenNow": false,
"Components": [
{
"OpenTime": "T100000",
"OpenDuration": "PT09H00M",
"Recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH"
},
{
"OpenTime": "T100000",
"OpenDuration": "PT07H00M",
"Recurrence": "FREQ:DAILY;BYDAY:FR"
},
{
"OpenTime": "T090000",
"OpenDuration": "PT08H00M",
"Recurrence": "FREQ:DAILY;BYDAY:SA"
},
{
"OpenTime": "T100000",
"OpenDuration": "PT06H00M",
"Recurrence": "FREQ:DAILY;BYDAY:SU"
}
]
}
],
"AccessPoints": [
{
"Position": [
-122.19944,
47.67801
]
}
]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Restore",
"Address": {
"Label": "Restore, 1520 Highlands Dr NE, Issaquah, WA 98029, United States",
"Country": {
"Code2": "US",
"Code3": "USA",
"Name": "United States"
},
"Region": {
"Code": "WA",
"Name": "Washington"
},
"SubRegion": {
"Name": "King"
},
"Locality": "Issaquah",
"District": "Issaquah Highlands",
"PostalCode": "98029",
"Street": "Highlands Dr NE",
"StreetComponents": [
{
"BaseName": "Highlands",
"Type": "Dr",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Suffix": "NE",
"Language": "en"
}
],
"AddressNumber": "1520"
},
"Position": [
-122.01868,
47.54262
],
"Distance": 209665,
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services",
"LocalizedName": "Wellness Center & Services",
"Primary": true
}
],
"BusinessChains": [
{
"Name": "Restore",
"Id": "Restore"
}
],
"Contacts": {
"Phones": [
{
"Value": "+14256518137"
}
],
"Websites": [
{
"Value": "https://restore.com",
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
},
{
"Value": "https://www.facebook.com/rhwissaquah",
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
},
{
"Value": "https://www.restore.com/locations",
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
},
{
"Value": "https://www.restore.com/locations/wa-issaquah-wa002?utm_source=extnet&utm_medium=Yext&y_source=1_MzE2Mjk5NTktNTY2LWxvY2F0aW9uLndlYnNpdGU%3D",
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
},
{
"Value": "https://www.restore.com/sitemap.xml",
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
}
],
"Emails": [
{
"Value": "issaquah@restore.com",
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
}
]
},
"OpeningHours": [
{
"Display": [
"Mon-Thu: 10:00 - 18:00",
"Fri: 10:00 - 17:00",
"Sat: 09:00 - 17:00"
],
"OpenNow": false,
"Components": [
{
"OpenTime": "T100000",
"OpenDuration": "PT08H00M",
"Recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH"
},
{
"OpenTime": "T100000",
"OpenDuration": "PT07H00M",
"Recurrence": "FREQ:DAILY;BYDAY:FR"
},
{
"OpenTime": "T090000",
"OpenDuration": "PT08H00M",
"Recurrence": "FREQ:DAILY;BYDAY:SA"
}
],
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
}
],
"AccessPoints": [
{
"Position": [
-122.01894,
47.54262
]
}
]
}
]
}
```
------
#### [ 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 '{
"QueryId": ""
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-id ""
```
------
# 如何使用特定语言进行搜索
此功能允许从 BCP47兼容代码中选择首选响应语言。它根据名称变体检测查询语言，并使用首选语言处理不匹配的令牌和模棱两可的情况。如果没有请求的语言，**地点** API 提供的结果将使用该国家/地区的官方语言，但在语言有差异的区域则优先使用当地语言。作为后备策略，如果请求的语言中没有任何地址元素不可用，“**地点**” 将以默认语言 APIs 返回地址。
## 潜在使用案例
一个潜在的用例是本地化查询结果 and/or 。
## 示例
### 获取特定语言的结果
如果请求中没有 `"Language": "EN"` 行，则将以希伯来语返回结果。
------
#### [ Sample request ]
```
{
"QueryText": "Vegan",
"BiasPosition":[
34.78953,
32.08556
],
"Language": "EN"
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Rainbow",
"Address": {
"Label": "Rainbow, Ibn Gabirol 88, 6404612 Tel Aviv-Yafo, Israel",
"Country": {
"Code2": "IL",
"Code3": "ISR",
"Name": "Israel"
},
"Region": {
"Code": "TA",
"Name": "TA"
},
"SubRegion": {
"Name": "Tel Aviv"
},
"Locality": "Tel Aviv-Yafo",
"District": "The New North-Southern Area",
"PostalCode": "6404612",
"Street": "Ibn Gabirol",
"StreetComponents": [
{
"BaseName": "Ibn Gabirol",
"Language": "he-Latn"
}
],
"AddressNumber": "88"
},
"Position": [
34.78149,
32.08252
],
"Distance": 829,
"Categories": [
{
"Id": "restaurant",
"Name": "Restaurant",
"LocalizedName": "Restaurant",
"Primary": true
},
{
"Id": "fast_food",
"Name": "Fast Food",
"LocalizedName": "Fast Food",
"Primary": false
}
],
"FoodTypes": [
{
"LocalizedName": "Vegan",
"Id": "vegan",
"Primary": true
},
{
"LocalizedName": "Fast Food",
"Id": "fast_food",
"Primary": false
},
{
"LocalizedName": "Burgers",
"Id": "burgers",
"Primary": false
},
{
"LocalizedName": "Jewish/Kosher",
"Id": "jewish/kosher",
"Primary": false
}
]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Alegria",
"Address": {
"Label": "Alegria, Ibn Gabirol 165, 6203305 Tel Aviv-Yafo, Israel",
"Country": {
"Code2": "IL",
"Code3": "ISR",
"Name": "Israel"
},
"Region": {
"Code": "TA",
"Name": "TA"
},
"SubRegion": {
"Name": "Tel Aviv"
},
"Locality": "Tel Aviv-Yafo",
"District": "The Old North-Northern Area",
"PostalCode": "6203305",
"Street": "Ibn Gabirol",
"StreetComponents": [
{
"BaseName": "Ibn Gabirol",
"Language": "he-Latn"
}
],
"AddressNumber": "165"
},
"Position": [
34.78295,
32.0923
],
"Distance": 973,
"Categories": [
{
"Id": "restaurant",
"Name": "Restaurant",
"LocalizedName": "Restaurant",
"Primary": true
},
{
"Id": "coffee_shop",
"Name": "Coffee Shop",
"LocalizedName": "Coffee Shop",
"Primary": false
},
{
"Id": "specialty_food_store",
"Name": "Specialty Food Store",
"LocalizedName": "Specialty Food Store",
"Primary": false
},
{
"Id": "bakery_and_baked_goods_store",
"Name": "Bakery and Baked Goods Store",
"LocalizedName": "Bakery & Baked Goods Store",
"Primary": false
}
],
"FoodTypes": [
{
"LocalizedName": "Vegan",
"Id": "vegan",
"Primary": true
}
]
}
]
}
```
------
#### [ 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": "Vegan",
"BiasPosition":[
34.78953,
32.08556
],
"Language": "EN"
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Vegan" \
--bias-position 34.78953 32.08556 \
--language "EN"
```
------