遷移至地點相片 (新)

Places API 支援現有的地點相片。如果你熟悉現有的地點相片,則 新版 Place Photo 進行下列變更:

  • 新的「地點相片」服務必須符合下列條件: 傳遞相片的資源名稱,其中包含地點 ID 要求網址,而不只是相片參考資料。若需更多資訊,請參閲 變更相片參考資料
  • 新的「地點相片」服務同時支援 API 金鑰OAuth 做為驗證機制

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

目前的參數 新增參數 附註
maxheight maxHeightPx 您必須指定 maxHeightPxmaxWidthPx,也可以同時指定這兩者。
maxwidth maxWidthPx 您必須指定 maxHeightPxmaxWidthPx,也可以同時指定這兩者。

已增加相片大小

現有的 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[]:任何必要的出處註明。這個欄位一律會出現,但可能為空白。