Places SDK for iOS 支持现有的地点照片。如果您熟悉现有的地点照片,新版地点照片会做出以下更改:
采用了新的定价模式。如需了解所有 API 的价格信息,请参阅 Places SDK for iOS(新版)的价格。
现有的地点照片支持的照片大小上限为 1600 x 1600 像素。地点照片(新)支持的尺寸上限为 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 } }]; }];