遷移至 Place Details (新推出)

Places API 支援現有的Place Details。如果您熟悉現有的 Places API，新版 Place Details 會進行以下變更：

• 必須使用欄位遮蓋功能。您必須指定要在回應中傳回哪些欄位。系統不會傳回預設欄位清單。如果省略這個清單，方法會傳回錯誤。詳情請參閱「FieldMask」。
• 新的 Place Details 支援使用 API 金鑰和 OAuth 權杖做為驗證機制。
• 新版 Place Details 僅支援 JSON 回應格式。
• Place Details (New) API 的 JSON 回應格式已變更為現有 API 的格式。詳情請參閱「遷移 Places API 回應」。

下表列出現有 Place Details 中已為新 Place Details 重新命名或修改的參數，或不再支援的參數。

目前的參數	新增參數	附註
place_id	places/PLACE_ID	字串 places/PLACE_ID 也稱為地點資源名稱。在 Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 要求的回應中，這個字串會包含在回應的 name 欄位中。獨立地點 ID 包含在回應的 id 欄位中。
language	languageCode
region	regionCode

要求範例

以下範例 GET 要求會使用現有的 Place Details。在這個範例中，您會要求 JSON 回應，其中包含地點 ID 相關資訊，並將所有參數設為網址參數。這個範例也使用 fields，因此回應只包含地點的顯示名稱和格式化地址：

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'

使用 Place Details (新版) 時，您可以發出 GET 要求，並將網址參數和標頭中的所有參數，做為要求的一部分傳遞。這個範例也使用欄位遮罩，因此回應只包含地點的顯示名稱和格式化地址：

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,formattedAddress" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

字串 places/PLACE_ID 也稱為位置資源名稱。在 Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 要求的回應中，這個字串會包含在回應的 name 欄位中。獨立地點 ID 包含在回應的 id 欄位中。