您可以使用 Places SDK for iOS (新版),要求在應用程式中顯示地點相片。相片服務傳回的相片來自各種來源,包括業主和使用者提供的相片。
相片是以 UIImage 物件表示的點陣圖圖片。點陣圖圖片的尺寸上限為 4800 x 4800 像素。
索取圖片
您最多可為單一地點索取 10 張相片:
呼叫
[GMSPlacesClient lookUpPhotosForPlaceID]
,傳遞地點 ID 和GMSPlacePhotoMetadataResultCallback
回呼。這項要求會使用GMSPlacePhotoMetadataList
物件呼叫GMSPlacePhotoMetadataResultCallback
回呼。在回呼中的
GMSPlacePhotoMetadataList
物件中,results
陣列屬性會包含相片,其中每張相片以GMSPlacePhotoMetadata
物件表示。針對陣列中的每個
GMSPlacePhotoMetadata
物件,呼叫[GMSPlacesClient loadPlacePhoto:callback:]
或[GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]
。這些方法會使用可用的點陣圖圖片做為 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 = photos.first else { return } // Request individual photos in the response list let fetchPhotoRequest = GMSFetchPhotoRequest(metadata: photoMetadata, maxSize: CGSizeMake(4800, 4800) placesClient.fetchPhoto(fetchPhotoRequest: fetchPhotoRequest, callback: { (photoURL: URL?, error: Error?) in guard let photoURL, error == nil else { return } print("Photo URL: \(photoURL)") }) };
Objective-C
// A hotel in Saigon with an attribution. NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs"; [placesClient lookUpPhotosForPlaceID:placeID callback: (GMSPlacePhotoMetadataList *list, NSError *error) { GMSPlacePhotoMetadata *photoMetadata = [list firstObject]; if (photoMetadata == nil) { return } // Request individual photos in the response list GMSFetchPhotoRequest *fetchPhotoRequest = [[GMSFetchPhotoRequest alloc] initWithPhotoMetadata:photoMetadata maxSize:CGSizeMake(4800, 4800)]; [placesClient fetchPhoto:fetchPhotoRequest, callback: ^(NSURL *_Nullable photoURL, NSError *_Nullable error) { if (error == null) { NSLog(@"Photo URL: %@", photoURL) } }]; }];
GooglePlacesSwift
// 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
中的基礎網址載入系統,在磁碟和記憶體中快取。
如要設定快取行為,您可以在應用程式委派的 application:didFinishLaunchingWithOptions:
方法中使用 [NSURLCache setSharedURLCache:]
,變更共用的網址快取。
如果您不希望應用程式與 Places SDK for iOS 共用 NSURLCache
,可以建立新的 NSURLCache
,然後在應用程式中單獨使用,而不設為共用快取。
出處
在大多數情況下,使用地點相片時無須註明出處,或者圖片會包含必要的作者資訊。不過,如果傳回的 GMSPlacePhotoMetadata
執行個體包含任何 attributions
或 authorAttribution
,您就必須在顯示圖片的任何位置,在應用程式中加入這些作者資訊。請參閱歸因說明文件。