遷移至 Place Details (新推出)

Places API 支援現有的 Place Details。如果您熟悉現有的 Places API，新版 Place Details 會做出下列變更：

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

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

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

要求範例

以下 GET 要求範例使用現有的 Place Details。在這個例子中，您會要求包含地點 ID 相關資訊的 JSON 回應，並將所有參數做為網址參數傳遞。這個範例也使用 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 (New) 即可發出 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 (New)、Nearby Search (New) 和 Text Search (New) 要求的回應中，這個字串會納入回應的 name 欄位中。獨立地點 ID 包含在回應的 id 欄位中。