Places API 支援現有的 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[]：任何必要的作者資訊。系統始終提供這個欄位，但可能會空白。