遷移至地點相片 (新)

Places API 支援Place Photo (舊版)。如果您熟悉舊版 Place Photo，新版 Place Photo 會進行以下變更：

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

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

目前的參數 新增參數 附註
maxheight maxHeightPx 您必須指定 maxHeightPx 或 maxWidthPx，或同時指定這兩者。
maxwidth maxWidthPx 您必須指定 maxHeightPx 或 maxWidthPx，或同時指定這兩者。

增加相片大小

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

變更為相片參考

Place Photo (新版) 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[]：任何必要的出處註明。這個欄位一律會出現，但可能為空白。