Places API 支持现有的文本搜索。如果您熟悉现有的文本搜索,不妨从新版文本搜索进行以下更改:
- 新的文本搜索使用 HTTP POST 请求。将参数作为 HTTP POST 请求的一部分在请求正文或标头中传递。相比之下,对于现有的文本搜索,您使用 HTTP GET 请求传递网址参数。
- 必须选择字段遮盖。您必须指定要在响应中返回的字段。没有返回字段的默认列表。如果您省略此列表,这些方法会返回错误。如需了解详情,请参阅 FieldMask。
- 新的文本搜索支持使用 API 密钥和 OAuth 令牌作为身份验证机制。
- 新的文本搜索仅支持 JSON 作为响应格式。
现有的文本搜索允许您在查询字符串中指定纬度和经度坐标。例如:
query=37.4239,-122.0925
。 新版文本搜索不支持该选项。- Text Search(新)API 的 JSON 响应格式与现有 API 的格式不同。如需了解详情,请参阅迁移 Places API 响应。
下表列出了现有文本搜索中已针对新文本搜索重命名或修改的参数,或不再受支持的参数。
当前参数 | 新增参数 | 备注 |
---|---|---|
evOptions |
新参数。 | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
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'