Places API 支援現有的地點相片。如果你熟悉現有的地點相片,則 新版 Place Photo 進行下列變更:
- 新的「地點相片」服務必須符合下列條件: 傳遞相片的資源名稱,其中包含地點 ID 要求網址,而不只是相片參考資料。若需更多資訊,請參閲 變更相片參考資料。
- 新的「地點相片」服務同時支援 API 金鑰 和 OAuth 做為驗證機制
下表列出現有地點相片中已為新地點相片重新命名或修改的參數,或不再支援的參數。
目前的參數 | 新增參數 | 附註 |
---|---|---|
maxheight |
maxHeightPx |
您必須指定 maxHeightPx 或 maxWidthPx ,也可以同時指定這兩者。 |
maxwidth |
maxWidthPx |
您必須指定 maxHeightPx 或 maxWidthPx ,也可以同時指定這兩者。 |
已增加相片大小
現有的 Place Photo 支援相片數量上限 大小為 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
新版的「搜尋附近」功能
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[]
:任何必要的出處註明。這個欄位一律會出現,但可能為空白。