您可以使用 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 调用回调。
为地点请求照片的另一种方法是发出地点详情(新)请求,在字段列表中添加 GMSPlacePropertyPhotos
。执行“地点详情”调用的优势在于,响应 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
,则无论在何处显示该图片,您都必须在应用中包含这些提供方说明。请参阅有关归因的文档。