迁移到地点照片（新）

此功能要求您启用新一代 Places API 的 Places API（新）。如需了解详情，请参阅启用 API。

Places SDK for iOS 支持现有的 Place Photo。如果您熟悉现有的地点照片，新版地点照片会进行以下更改：

• 使用新的价格模式。如需了解所有 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
    }
  }];
}];