遷移至 Place Details (新推出)

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

  • 必須遮蓋欄位。您必須指定要傳回的欄位 回應。沒有預設的傳回欄位清單。如果您省略 清單中,這些方法會傳回錯誤。若需更多資訊,請參閲 FieldMask
  • 新的 Place Details 支援這兩種格式 API 金鑰OAuth 做為驗證機制
  • 新的 Place Details。
  • 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 欄位。