遷移至 Autocomplete (新推出)

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

簡介

Places API 支援 Place Autocomplete (舊版) 和 Query Autocomplete (舊版) API。如果您熟悉這些 API，Autocomplete (新版) 會進行下列變更：

  • Autocomplete (新版) 會使用 HTTP POST 要求。在要求主體或標頭中，將參數傳遞為 HTTP POST 要求的一部分。相反地，使用舊版 API 時，您必須使用 HTTP GET 要求傳遞網址參數。
  • Autocomplete (新版) 支援 API 金鑰和 OAuth 符記做為驗證機制。
  • 在「自動完成」(新版) 中，系統僅支援 JSON 做為回應格式。

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

目前的參數 新增參數 附註
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 (新版) 時，您會發出 POST 要求，並在 JSON 要求主體或標頭中傳遞所有參數，做為 POST 要求的一部分。

自動完成 (新版) 要求不需要使用欄位遮罩，但可用於篩選回應中的特定結果。舉例來說，下列要求會使用欄位遮罩，因此回應只會包含建議的 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

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