遷移至新版地點相片

專案：/maps/documentation/places/web-service/_project.yaml 書籍：/maps/documentation/places/web-service/_book.yaml

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

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

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

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

增加相片大小

Place 相片 (舊版) 支援的最大相片大小為 1600 x 1600 像素。Place 相片 (新版) 支援的大小上限為 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[]：任何必要的出處註明。這個欄位一律會出現，但可能為空白。