遷移至新版地點相片

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

簡介

Places API 支援地點相片 (舊版)。如果您熟悉 Place Photos (舊版)，Place Photos (新版) 有以下異動：

  • Place Photos (新版) 要求您傳遞相片的資源名稱，其中包含要求網址中的地點 ID，而不只是相片參照。詳情請參閱「相片參照異動」。
  • Place Photos (新版) 支援 API 金鑰和 OAuth 權杖做為驗證機制。

下表列出 Place Photos (舊版) 中，已重新命名或修改為 Place Photos (新版) 的參數，或是不再支援的參數。

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

相片大小上限提高

Place Photos (舊版) 支援的相片大小上限為 1600 x 1600 像素。Place Photos (新版) 支援的大小上限為 4800 x 4800 像素。

改用參考相片

Place Photos (新版) 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[]：任何必要的出處資訊。這個欄位一律會顯示，但可能為空。