簡介
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 |
如果省略 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 要求的一部分。
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
如要進一步瞭解如何使用欄位遮罩，請參閱「地點詳細資料 (新版)」。