简介
Places API（旧）支持 文本搜索（旧）。如果您熟悉 文本搜索（旧）， 文本搜索（新） 会进行以下更改：
- 文本搜索（新）使用 HTTP POST 请求。在请求正文或标头中传递参数，作为 HTTP POST 请求的一部分。相比之下，使用文本搜索（旧）时，您可以使用 HTTP GET 请求传递 网址参数。
- 必须使用字段掩码。您必须指定要在响应中返回的字段。 没有返回字段的默认列表。如果您省略 此列表，这些方法会返回错误。如需了解详情，请参阅 FieldMask。
- 文本搜索（新）同时支持 API 密钥 和 OAuth 令牌作为身份验证机制。
- 在文本搜索（新）中，仅支持 JSON 作为响应格式。
文本搜索（旧）允许您在查询字符串中指定纬度和经度 坐标。例如：
query=37.4239,-122.0925。 文本搜索（新）不支持该选项。- 文本搜索（新） 的 JSON 响应格式已从旧版 API 的格式更改。如需了解详情，请参阅 迁移 Places API 响应。
下表列出了文本搜索（旧）中已针对文本搜索（新）重命名或修改的参数，或不再受支持的参数。
| 当前参数 | 新参数 | 备注 |
|---|---|---|
evOptions |
新参数。 | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
pageToken |
|
query |
textQuery |
在所有请求中都是必填字段。 |
radius |
locationBias |
定义 locationBias 时指定半径。 |
region |
regionCode |
|
type |
includedType |
仅接受单个值。 |
strictTypeFiltering |
新参数。 |
示例请求
以下示例 GET 请求使用文本搜索（旧）。在此示例中，您请求包含“澳大利亚悉尼的香辣素食”相关信息的 JSON 响应，并将所有参数作为网址参数传递：
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
使用文本搜索（新）时，您需要发出 POST 请求，并在 JSON 请求正文或标头中传递所有参数，作为 POST 请求的一部分。此示例还使用了字段掩码，因此响应仅包含地点的显示名称和格式化地址：
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'