遷移至新版地點相片

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

簡介

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

  • Place Photos (New) 規定您必須傳遞相片的資源名稱 (包括要求網址中的地點 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 像素。

改用相片參考資料

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