遷移至地點相片 (新)

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

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

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

目前的參數 新增參數 附註
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[] 回應這種格式的回應。現有 Pod 中的每個 photo 元素 回應包含以下欄位：

  • photo_reference — 當您在移動要求時用來識別相片的字串 執行相片要求
  • height：圖片的最大高度。
  • width：圖片的寬度上限。
  • html_attributions[]：任何必要的作者資訊。這個 欄位始終存在，但可能留空。