遷移至 Place Details (新推出)

Places API 支援現有的 Place Details。 如果您熟悉現有的 Places API 新版 Place Details 進行下列變更:

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

下表列有現有參數 已重新命名或修改的地點詳細資料 新的 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 欄位。