遷移至 Autocomplete (新推出)

Places API 支援現有的 Autocomplete 和 Query Autocomplete API。如果您熟悉這些 API，自動完成 (新版) 會進行下列變更：

• Autocomplete (新版) 使用 HTTP POST 要求。將參數做為 HTTP POST 要求的一部分，傳入要求主體或標頭中。相較之下，與現有的 API 相比，您會使用 HTTP GET 要求傳送網址參數。
• Autocomplete (新版) 同時支援 API 金鑰和 OAuth 權杖做為驗證機制。
• Autocomplete (新版) 僅支援 JSON 做為回應格式。

下表列出或修改過 Autocomplete (新版) 或不再支援的參數，以及已重新命名或修改的現有 Autocomplete 和 Query Autocomplete API 中的參數。

目前的參數	新增參數	附註
components	includedRegionCodes
language	languageCode
location	locationBias
ipbias		如果您同時省略 locationBias 和 locationRestriction，則 API 預設會使用 IP 自訂調整。
offset	inputOffset
radius	locationBias 或 locationRestriction
region	regionCode
stricbounds	locationRestriction
sessiontoken	sessionToken
types	includedPrimaryTypes

要求範例

以下 GET 要求範例使用現有的 Place Autocomplete。在本範例中，您要求 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'

使用 Autocomplete New 時，您可以發出 POST 要求，並做為 POST 要求的一部分傳送 JSON 要求主體或標頭中的所有參數。此範例也使用欄位遮罩，因此回應只包含地點的顯示名稱和格式化地址：

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