遷移至 Autocomplete (新推出)

歐洲經濟區 (EEA) 開發人員

簡介

Places API 支援地點自動完成 (舊版)查詢自動完成 (舊版) API。如果您熟悉這些 API,Autocomplete (New) 會進行下列變更:

  • Autocomplete (新版) 使用 HTTP POST 要求。在要求主體或標頭中傳遞參數,做為 HTTP POST 要求的一部分。相較之下,使用舊版 API 時,您會透過 HTTP GET 要求傳遞網址參數。
  • 自動完成 (新版) 支援 API 金鑰OAuth 權杖做為驗證機制。
  • 在「自動完成 (新版)」中,僅支援 JSON 做為回應格式。

下表列出 Place Autocomplete (舊版) 和 Query Autocomplete (舊版) 中已重新命名或修改的參數,以及 Autocomplete (新版) 不再支援的參數。

目前參數 新增參數 附註
components includedRegionCodes
language languageCode
location locationBias
ipbias 如果省略 locationBiaslocationRestriction,API 預設會使用 IP 偏誤。
offset inputOffset
radius locationBiaslocationRestriction
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 (新版) 時,您會發出 POST 要求,並在 JSON 要求內文或標頭中,傳遞所有參數做為 POST 要求的一部分。

Autocomplete (New) 要求不需要欄位遮罩,但可用於篩選回應中的特定結果。舉例來說,下列要求使用欄位遮罩,因此回應只會包含建議的 suggestions.placePrediction.text

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' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

如要進一步瞭解如何使用欄位遮罩,請參閱「地點詳細資料 (新版)」。