您可以使用 Places SDK for iOS (新版),向 顯示在整個應用程式中地點相片服務傳回的相片來自各種來源,包括業主和使用者提供的相片。
相片是點陣圖圖像 UIImage 物件。 點陣圖圖片的尺寸上限為 4800 x 4800 像素。
要求取得圖片
您最多可以為一個地點要求 10 張相片:
致電
[GMSPlacesClient lookUpPhotosForPlaceID]
、 並傳遞地點 IDGMSPlacePhotoMetadataResultCallback
回呼。 這項要求會呼叫GMSPlacePhotoMetadataResultCallback
回呼與GMSPlacePhotoMetadataList
物件。透過回呼中的
GMSPlacePhotoMetadataList
物件,results
陣列 屬性包含相片,其中每張相片都以GMSPlacePhotoMetadata
物件。使用
GMSPlacePhotoMetadata
物件建立GMSFetchPhotoRequest
,包括要求圖片的最大大小。針對陣列中的每個
GMSPlacePhotoMetadata
物件,呼叫[GMSPlacesClient fetchPhotoWithRequest:callback:]
傳遞GMSFetchPhotoRequest
物件。這個方法會呼叫GMSFetchPhotoResultCallback
敬上 回呼,並使用可用的點陣圖圖片做為 UIImage。
請求地點相片的另一個方法是,
Place Details (新) 要求,
並在欄位清單中加入 GMSPlacePropertyPhotos
掌握優勢
Place Details 呼叫指的是
GMSPlace
敬上
物件,可包含相片和任何其他您要
該地點。
程式碼範例
以下範例方法會使用地點 ID,並取得傳回清單中的第一張相片。您可以使用此方法做為範本, 建立自己的應用程式
Swift
// A hotel in Saigon with an attribution. let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs" // Request list of photos for a place placesClient.lookUpPhotos(forPlaceID: placeID) { (photos, error) in guard let photoMetadata: GMSPlacePhotoMetadata = photos?.results[0] else { return } // Request individual photos in the response list let fetchPhotoRequest = GMSFetchPhotoRequest(photoMetadata: photoMetadata, maxSize: CGSizeMake(4800, 4800)) self.client.fetchPhoto(with: fetchPhotoRequest, callback: { (photoImage: UIImage?, error: Error?) in guard let photoImage, error == nil else { print("Handle photo error: ") return } print("Display photo Image: ") } ) }
Objective-C
// A hotel in Saigon with an attribution. NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs"; [placesClient lookUpPhotosForPlaceID:placeID callback: ^(GMSPlacePhotoMetadataList *list, NSError *error) { GMSPlacePhotoMetadata *photoMetadata = [list results][0]; // Request individual photos in the response list GMSFetchPhotoRequest *fetchPhotoRequest = [[GMSFetchPhotoRequest alloc] initWithPhotoMetadata:photoMetadata maxSize:CGSizeMake(4800, 4800)]; [placesClient fetchPhotoWithRequest:fetchPhotoRequest callback: ^(UIImage *_Nullable photoImage, NSError *_Nullable error) { if (error == nil) { // Display photo } }]; }];
Places Swift SDK for iOS (預先發布版)
// First fetch place details // A hotel in Saigon with an attribution. let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs" let fetchPlaceRequest = FetchPlaceRequest( placeID: placeID, placeProperties: [ . name, .website ] ) var fetchedPlace: Place switch await placesClient.fetchPlace(with: fetchPlaceRequest) { case .success(let place): fetchedPlace = place case .failure(let placesError): // Handle error } // Use the place details to fetch a photo's image. guard let photo = fetchedPlace.photos?.first else { // Handle place without photos. } let fetchPhotoRequest = FetchPhotoRequest(photo: photo, maxSize: CGSizeMake(4800, 4800)) switch await placesClient.fetchPhoto(with: fetchPhotoRequest) { case .success(let uiImage): // Handle image. case .failure(let placesError): // Handle error }
快取
使用 [GMSPlacesClient loadPlacePhoto:callback:]
或 [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]
載入的相片,會由共用 NSURLCache
中的 Foundation URL 載入系統快取到磁碟和記憶體中。
如要設定快取行為,您可以使用
[NSURLCache setSharedURLCache:]
敬上
在應用程式委派的 application:didFinishLaunchingWithOptions:
中
方法。
如果您不希望應用程式將 NSURLCache
與
Places SDK for iOS 可以建立新的 NSURLCache
,
單獨使用的應用程式,而不設為共用快取。
歸因
在大多數情況下,使用地點相片時不必註明出處,
在圖片中加入所需的作者資訊。不過,如果傳回
GMSPlacePhotoMetadata
敬上
執行個體均包含
attributions
或
authorAttribution
,
您必須在應用程式中加入這些作者資訊,
圖片。請參閱歸屬說明文件。