遷移至地點相片 (新)

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

• 使用新的定價模式。如需所有 API 的定價資訊，請參閱 Places SDK for Android (新版)。

• 現有的地點相片會傳回點陣圖。Place Photo (New) 會傳回圖片的 URI。

• 現有的地點相片最多可支援 1600 x 1600 像素的相片大小。新版 Place Photo 支援的大小上限為 4800 x 4800 像素。

• 如要提出要求，請呼叫新的 PlacesClient.fetchResolvedPhotoUri() 方法。

• 您必須啟用 Places API，才能呼叫 PlacesClient.fetchPhoto() 方法。如果您只啟用 Places API (新版)，就無法使用這項方法。

  詳情請參閱「使用 API 金鑰」。

• 將新 FetchResolvedPhotoUriRequest 類別的物件傳遞至要求。

• 回應中的每張相片都會以 PhotoMetadata 物件表示。針對 Places SDK for Android (新版)，PhotoMetadata 物件包含新的 PhotoMetadata.getAuthorAttributions() 方法，可傳回 AuthorAttributions 類型的物件。

  如果傳回的 PhotoMetadata 物件包含任何出處資訊或作者資訊，您每次顯示圖片時就必須在應用程式中加入這些出處資訊。請參閱歸屬說明文件。

• 如要在 PhotoMetadata 中存取新的作者歸屬資訊，您必須呼叫 Places.initializeWithNewPlacesApiEnabled() 方法來初始化應用程式。如要進一步瞭解如何選取 Places API 服務，請參閱「設定 Google Cloud 專案」。

要求範例

如需完整範例，請參閱「Place Photo (新版)」。