迁移到地点照片（新）

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

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
    }
  }];
}];