本頁面由 Cloud Translation API 翻譯而成。

遷移至地點相片 (新)

Places SDK for iOS 支援現有的 Place Photo。如果您熟悉現有的地點相片，新版 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
    }
  }];
}];