您可以使用 Places SDK for iOS(新)请求要在应用中显示的地点照片。照片服务返回的照片来自各种来源,包括商家所有者和用户贡献的照片。
照片是由 UIImage 对象表示的位图图片。位图图像的最大尺寸为 4800 x 4800 像素。
请求图片
您最多可以为一个地点请求 10 张照片:
调用
[GMSPlacesClient lookUpPhotosForPlaceID]
,以传递地点 ID 和GMSPlacePhotoMetadataResultCallback
回调。此请求使用GMSPlacePhotoMetadataList
对象调用GMSPlacePhotoMetadataResultCallback
回调。在回调的
GMSPlacePhotoMetadataList
对象中,results
数组属性包含照片,其中每张照片都由一个GMSPlacePhotoMetadata
对象表示。使用
GMSPlacePhotoMetadata
对象创建GMSFetchPhotoRequest
,包括所请求图片的大小上限。对于数组中的每个
GMSPlacePhotoMetadata
对象,调用[GMSPlacesClient fetchPhotoWithRequest:callback:]
并传入GMSFetchPhotoRequest
对象。此方法使用可用的位图图像作为 UIImage 调用GMSFetchPhotoResultCallback
回调。
为地点请求照片的另一种方法是发出地点详情(新)请求,在字段列表中添加 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: 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 } }]; }];
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
,则无论在何处显示该图片,您都必须在应用中包含这些提供方说明。请参阅有关归因的文档。