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

遷移至地點相片 (新)

Places SDK for iOS 支援現有的 Place 相片。如果您熟悉現有的 Place Photo，新版 Place Photo 會進行以下變更：

使用新的定價模式。如需所有 API 的定價資訊，請參閱「Places SDK for iOS (新版) 的定價」。
現有的地點相片最多可支援 1600 x 1600 像素的圖片大小。新版 Place Photo 支援的大小上限為 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
    }
  }];
}];