遷移至地點相片 (新)

Places API 支援現有的 Place Photo。如果您熟悉現有的地點相片，新版 Place Photo 會進行下列變更：

  • 新的「地點相片」服務要求您傳送相片的資源名稱，其中包含地點 ID 位於要求網址，而非只有相片參照。詳情請參閱「相片參考資料變更」一文。
  • 新的地點相片服務同時支援 API 金鑰和 OAuth 權杖做為驗證機制。

下表列出了現有地點相片中，已重新命名或修改的新「地點相片」的參數，或系統不再支援的參數。

目前的參數 新增參數 附註
maxheight maxHeightPx 您必須指定 maxHeightPx 和/或 maxWidthPx。
maxwidth maxWidthPx 您必須指定 maxHeightPx 和/或 maxWidthPx。

已增加相片大小

現有地點相片支援的相片大小上限為 1600 x 1600 像素。地點相片 (新版) 支援的尺寸最高為 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[]：任何必要的作者資訊。這個欄位一律存在，但可能留空。