遷移至新版地點相片

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

簡介

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

  • 使用 Place Photos (New) 時，您必須傳遞相片的資源名稱 (包括要求網址中的地點 ID)，而非僅傳遞相片參照。詳情請參閱「改用相片參照」。
  • Place Photos (New) 支援 API 金鑰和 OAuth 權杖做為驗證機制。

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

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

相片大小增加

Place Photos (舊版) 支援的最大相片尺寸為 1600 x 1600 像素。「地點相片 (新版)」支援最大 4800 x 4800 像素的圖片。

改用相片參考資料

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