地點相片 (新)

選取平台: Android iOS 網路服務

您可以使用 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。

請求地點相片的另一個方法是, Place Details (新) 要求, 並在欄位清單中加入 GMSPlacePropertyPhotos掌握優勢 Place Details 呼叫指的是 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 中的 Foundation URL 載入系統快取到磁碟和記憶體中。

如要設定快取行為,您可以使用 [NSURLCache setSharedURLCache:]敬上 在應用程式委派的 application:didFinishLaunchingWithOptions: 中 方法。

如果您不希望應用程式將 NSURLCache 與 Places SDK for iOS 可以建立新的 NSURLCache, 單獨使用的應用程式,而不設為共用快取。

歸因

在大多數情況下,使用地點相片時不必註明出處, 在圖片中加入所需的作者資訊。不過,如果傳回 GMSPlacePhotoMetadata敬上 執行個體均包含 attributionsauthorAttribution, 您必須在應用程式中加入這些作者資訊, 圖片。請參閱歸屬說明文件。