Places SDK for Android 支援地點相片 (舊版)。如果您熟悉 Place Photo (舊版), Place Photo (新版) 會進行下列變更:
採用新的定價模式。如要瞭解所有 API 的價格資訊,請參閱「 Places SDK for Android (新版)」。
Place Photo (舊版) 會傳回點陣圖圖片。 地點相片 (新版) 會傳回圖片的 URI。
Place Photo (舊版) 支援的相片大小上限為 1600 x 1600 像素。新版地點相片支援的最大尺寸為 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 專案」一文。
要求範例
如需完整範例,請參閱「地點相片 (新版)」。