地点照片(新)

选择平台Android iOS Web 服务

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

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

请求图片

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

  1. 致电 [GMSPlacesClient lookUpPhotosForPlaceID]、 传递地点 ID 和 GMSPlacePhotoMetadataResultCallback 回调。 此请求会调用 GMSPlacePhotoMetadataResultCallback 回调,其中包含以下参数: GMSPlacePhotoMetadataList 对象。

  2. 通过回调中的 GMSPlacePhotoMetadataList 对象, results 数组属性包含照片,其中每张照片都由 GMSPlacePhotoMetadata 对象。

  3. 使用 GMSPlacePhotoMetadata 对象创建一个 GMSFetchPhotoRequest, 包括所请求图片的最大尺寸

  4. 对于数组中的每个 GMSPlacePhotoMetadata 对象,请调用 [GMSPlacesClient fetchPhotoWithRequest:callback:] 传递 GMSFetchPhotoRequest 对象。此方法会调用 GMSFetchPhotoResultCallback 回调,并使用可用的位图图像作为 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: 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
    }
  }];
}];

Places Swift SDK for iOS(预览版)

// 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:] 更改共享的网址缓存。

如果您不希望应用与NSURLCache 您可以使用 Places SDK for iOS,创建一个新的 NSURLCache,并使用它 而不将其设为共享缓存。

归因

在大多数情况下,使用地点照片时可以不包含提供方说明,或者 必须注明出处。不过,如果返回的 GMSPlacePhotoMetadata 实例包含 attributionsauthorAttribution, 您必须在应用中显示 图片。请参阅 归因