地点照片（新）

您可以使用 Places SDK for iOS（新）请求要在应用中显示的地点照片。照片服务返回的照片来自各种来源，包括商家所有者和用户贡献的照片。

照片是由 UIImage 对象表示的位图图片。位图图像的最大尺寸为 4800 x 4800 像素。

请求图片

您最多可以为一个地点请求 10 张照片：

  1. 调用 [GMSPlacesClient lookUpPhotosForPlaceID]，以传递地点 ID 和 GMSPlacePhotoMetadataResultCallback 回调。此请求使用 GMSPlacePhotoMetadataList 对象调用 GMSPlacePhotoMetadataResultCallback 回调。

  2. 在回调的 GMSPlacePhotoMetadataList 对象中，results 数组属性包含照片，其中每张照片都由一个 GMSPlacePhotoMetadata 对象表示。

  3. 对于数组中的每个 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，则无论在何处显示该图片，您都必须在应用中包含这些提供方说明。请参阅有关归因的文档。