迁移到自动补全(新)

Places API 支持现有的 自动补全Query Autocomplete API。 如果您熟悉这些 API,自动补全(新)会做出以下更改:

  • 自动补全(新)使用 HTTP POST 请求。传入参数 作为 HTTP POST 请求的一部分包含在请求正文或标头中相比之下, 与现有的 API 结合使用,您可以使用 HTTP GET 请求。
  • 自动补全(新)同时支持两种 API 密钥 并使用 OAuth 令牌作为身份验证机制。
  • 自动补全(新)仅支持 JSON 作为响应格式。

下表列出了现有 已针对 Autocomplete(新)重命名或修改的 Autocomplete API 和 Query Autocomplete API,或不再受支持的参数。

当前参数 新增参数 备注
components includedRegionCodes
language languageCode
location locationBias
ipbias 如果您同时省略 locationBiaslocationRestriction,则 API 默认使用 IP 自定义调整。
offset inputOffset
radius locationBiaslocationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

示例请求

以下示例 GET 请求使用现有的 地点自动补全。在此示例中,您将请求一个 JSON 包含名为“Amoeba”的地点相关信息的响应属于 establishment 并将所有参数作为网址参数传递:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

借助自动补全(新)功能,您可以发出 POST 请求并 将 JSON 请求正文或标头中的所有参数作为 POST 的一部分传递 请求。此示例还使用了字段掩码,因此响应仅包含 地点的显示名称和设置了格式的地址:

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete