Places SDK for iOS(旧版)支持地点照片(旧版)。 如果您熟悉 Place Photos(旧版),Place Photos(新版)进行了以下更改:
采用新的价格模式。如需了解所有 API 的价格信息,请参阅用量和结算。
Place Photos(旧版)支持的最大照片尺寸为 1600x1600 像素。地点照片(新版)支持最大 4800 x 4800 像素的尺寸。
如需发出请求,请调用新的
GMSPlacesClient fetchPhotoWithRequest:callback:方法。传递给请求:
新的
GMSFetchPhotoRequest类的实例,用于定义所有请求参数,包括图片大小上限。用于处理响应的
GMSPlacePhotoMetadataResultCallback类型的回调。
每张照片都由一个
GMSPlacePhotoMetadata实例表示。对于 Places SDK for iOS(新版),GMSPlacePhotoMetadata实例包含一个新的authorAttribution字段,该字段由新的GMSPlaceAuthorAttribution类表示。如果返回的
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 } }]; }];