迁移到地点照片（新）

此功能要求您启用 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 实例包含一个新 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
    }
  }];
}];