Android 版 Places SDK 支援現有的 Place 相片。如果您熟悉現有的地點相片,新版地點相片會進行以下變更:
使用新的定價模式。如需所有 API 的定價資訊,請參閱 Android 版 Places SDK (新版)。
現有的地點相片會傳回點陣圖圖片。Place Photo (New) 會傳回圖片的 URI。
現有的地點相片支援的最大相片大小為 1600 x 1600 像素。新版 Place Photo 支援的大小上限為 4800 x 4800 像素。
如要提出要求,請呼叫新的
PlacesClient.fetchResolvedPhotoUri()
方法。您必須啟用 Places API,才能呼叫
PlacesClient.fetchPhoto()
方法。如果您只啟用 Places API (新版),就無法使用這項方法。詳情請參閱「使用 API 金鑰」。
將新
FetchResolvedPhotoUriRequest
類別的物件傳遞至要求。回應中的每張相片都以
PhotoMetadata
物件表示。針對 Android 版 Places SDK (新版),PhotoMetadata
物件包含新的PhotoMetadata.getAuthorAttributions()
方法,可傳回AuthorAttributions
類型的物件。如果傳回的
PhotoMetadata
物件包含任何作者或出處資訊,您必須在應用程式中顯示圖片的所有位置加入這些資訊。請參閱歸因說明文件。如要在
PhotoMetadata
中存取新的作者歸屬資訊,您必須呼叫Places.initializeWithNewPlacesApiEnabled()
方法來初始化應用程式。如要進一步瞭解如何選取 Places API 服務,請參閱「設定 Google Cloud 專案」。
要求範例
如需完整範例,請參閱「Place Photo (新版)」。