遷移至地點相片 (新)

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

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

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

目前的參數	新增參數	附註
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[]：任何必要的出處註明。這個欄位一律會出現，但可能為空白。