遷移至新版地點相片

歐洲經濟區 (EEA) 開發人員

簡介

Places API 支援地點相片 (舊版)。如果您熟悉 Place Photos (舊版)，Place Photos (新版)會進行下列變更：

  • 地點照片（新增）要求您傳遞照片的資源名稱，其中包含請求 URL 中的地點 ID，而不僅僅是照片引用。詳情請參閱「改用相片參考資料」。
  • Place Photos (新推出) 支援 API 金鑰和 OAuth 權杖做為驗證機制。

下表列出「地點相片」(舊版) 中已重新命名或修改的參數，以及「地點相片」(新版) 中不再支援的參數。

目前參數 新增參數 附註
maxheight maxHeightPx 您必須指定 maxHeightPx、maxWidthPx 或兩者。
maxwidth maxWidthPx 您必須指定 maxHeightPx、maxWidthPx 或兩者。

相片變大

Place Photos (舊版) 支援的相片大小上限為 1600 x 1600 像素。「放置照片（新增）」功能支援最大 4800 x 4800 像素的圖片尺寸。

改用相片參考資料

地點相片 (新版) API 必須傳遞所要求相片的資源名稱，包括地點 ID 和相片參照，格式如下：

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

Nearby Search (新版)、Text Search (新版) 和 Place Details (新版) 都會在回應中傳回支援此格式的 photos[] 陣列。新回應中的每個元素 photos[] 都包含以下欄位：

  • name — 包含照片資源名稱的字串。這個字串的格式如下：

    places/PLACE_ID/photos/PHOTO_REFERENCE
  • heightPx：圖片的高度上限 (以像素為單位)。
  • widthPx：圖片寬度上限 (以像素為單位)。
  • authorAttributions[] - 任何必要出處資訊。這個欄位一律會顯示，但可能為空白。

使用舊版 API 時，您只需要傳遞相片參照，格式如下：

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

Find Place (舊版)、Nearby Search (舊版)、Text Search (舊版) 和 Place Details (舊版) 都會在回應中傳回 photos[] 陣列，支援這種格式。舊版回應中的每個 photo 元素都包含下列欄位：

  • photo_reference：執行相片要求時，用來識別相片的字串。
  • height：圖片的最大高度。
  • width：圖片寬度上限。
  • html_attributions[] - 任何必要出處資訊。這個欄位一律會顯示，但可能為空。