Places SDK for iOS 支持地点照片(旧版)。如果您熟悉 Place Photo(旧版),Place Photo(新版)会进行以下更改:
采用新的价格模式。如需了解所有 API 的价格信息,请参阅 Places SDK for iOS(新)的价格。
Place Photo(旧版)支持的最大照片尺寸为 1600x1600 像素。Place Photo(新)支持的最大尺寸为 4800 x 4800 像素。
如需发出请求,请调用新的
GMSPlacesClient fetchPhotoWithRequest:callback:
方法。传递给请求:
一个新
GMSFetchPhotoRequest
类的实例,用于定义所有请求参数,包括最大图片大小。用于处理响应的回调,类型为
GMSPlacePhotoMetadataResultCallback
。
每张照片都由一个
GMSPlacePhotoMetadata
实例表示。对于 Places SDK for iOS(新),GMSPlacePhotoMetadata
实例包含由新GMSPlaceAuthorAttribution
类表示的新authorAttribution
字段。如果返回的
GMSPlacePhotoMetadata
实例包含attributions
或authorAttribution
,无论您在哪里显示相应图片,都要在应用中包含这些提供方信息。请参阅有关提供方信息的文档。
示例请求
以下示例方法会获取地点 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 } }]; }];