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 (新版)」。