地點相片

選取平台： Android iOS JavaScript 網頁服務

您可以使用 Places SDK for iOS 要求應用程式內顯示的地點相片。「地點相片」服務傳回的相片取自各種來源，包括業主和使用者提供的相片。如要擷取地點的相片，您必須採取下列步驟：

  1. 呼叫 [GMSPlacesClient fetchPlaceFromPlaceId]，傳遞包含地點 ID 和回呼的字串。這項操作會使用 GMSPlacePhotoMetadataList 物件呼叫回呼。
  2. 使用 GMSPlacePhotoMetadataList 物件存取 results 屬性，然後選取要從陣列載入的相片。
  3. 針對每項這份清單載入每個 GMSPlacePhotoMetadata，呼叫 [GMSPlacesClient loadPlacePhoto:callback:] 或 [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]。這些呼叫會使用可用的 UI 圖片呼叫回呼。相片的寬度或高度上限為 1600 像素。

程式碼範例

以下範例方法使用地點 ID，並取得回傳清單中的第一張相片。您可以用這個方法做為您在自己的應用程式中建立的方法的範本。

Swift

// Specify the place data types to return (in this case, just photos).
let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.photos.rawValue))!

placesClient?.fetchPlace(fromPlaceID: "INSERT_PLACE_ID_HERE",
                         placeFields: fields,
                         sessionToken: nil, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    // Get the metadata for the first photo in the place photo metadata list.
    let photoMetadata: GMSPlacePhotoMetadata = place.photos![0]

    // Call loadPlacePhoto to display the bitmap and attribution.
    self.placesClient?.loadPlacePhoto(photoMetadata, callback: { (photo, error) -> Void in
      if let error = error {
        // TODO: Handle the error.
        print("Error loading photo metadata: \(error.localizedDescription)")
        return
      } else {
        // Display the first image and its attributions.
        self.imageView?.image = photo;
        self.lblText?.attributedText = photoMetadata.attributions;
      }
    })
  }
})

Objective-C

// Specify the place data types to return (in this case, just photos).
GMSPlaceField fields = (GMSPlaceFieldPhotos);

NSString *placeId = @"INSERT_PLACE_ID_HERE";

[_placesClient fetchPlaceFromPlaceID:placeId placeFields:fields sessionToken:nil callback:^(GMSPlace * _Nullable place, NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"An error occurred %@", [error localizedDescription]);
    return;
  }
  if (place != nil) {
    GMSPlacePhotoMetadata *photoMetadata = [place photos][0];
    [self->_placesClient loadPlacePhoto:photoMetadata callback:^(UIImage * _Nullable photo, NSError * _Nullable error) {
      if (error != nil) {
        NSLog(@"Error loading photo metadata: %@", [error localizedDescription]);
        return;
      } else {
        // Display the first image and its attributions.
        self->imageView.image = photo;
        self->lblText.attributedText = photoMetadata.attributions;
      }
    }];
  }
}];

快取

使用 [GMSPlacesClient loadPlacePhoto:callback:] 或 [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:] 載入的相片，會透過共用 NSURLCache 的基礎網址載入系統，在磁碟和記憶體內快取。

如要設定快取行為，您可以使用應用程式委派的 application:didFinishLaunchingWithOptions: 方法中的 [NSURLCache setSharedURLCache:] 變更共用網址快取。

如果您不想讓應用程式與 Places SDK for iOS 共用 NSURLCache，可以建立新的 NSURLCache，並在應用程式中專門使用，無須將其設定為共用快取。

歸因

在大多數情況下，使用地點相片時即可直接使用作者資訊，也可能在圖片中加入必要的作者資訊。不過，如果傳回的 GMSPlacePhotoMetadata 執行個體含有作者資訊，您就必須在顯示圖片的應用程式中加入額外的作者資訊。請注意，歸因中的連結必須可輕觸。請參閱歸因分析說明文件。

用量限制

擷取圖片會產生 1 個單位的配額，擷取相片中繼資料也沒有用量限制。進一步瞭解用量與計費。