場所の写真（新規）

Places SDK for iOS（新版）を使用すると、場所の写真をリクエストして、 表示されます。写真サービスから返される写真は、 ビジネス オーナーやユーザーが投稿した写真など、さまざまな情報源を利用できます。

写真はビットマップ画像で、 UIImage オブジェクトを作成します。 ビットマップ画像の最大サイズは 4,800 x 4,800 ピクセルです。

画像をリクエストする

1 か所につき最大 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 を受け取り、 返されます。このメソッドは、今後実行するメソッドのテンプレートとして使用できます。 作成する方法を学びます。

// 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: ")
    }
  )
}

// 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
    }
  }];
}];

// 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:] 基盤 URL 読み込みシステムによってディスクとメモリ内の両方にキャッシュされる 内の共有アイテム NSURLCache です。

キャッシュ動作を構成するには、次のコマンドを使用して共有 URL キャッシュを変更します。 [NSURLCache setSharedURLCache:] （アプリケーション デリゲートの application:didFinishLaunchingWithOptions:） メソッドを呼び出します。

アプリケーションが NSURLCache を Places SDK for iOS では、新しい NSURLCache を作成してこれを使用できます 共有キャッシュとして設定する必要はありません

帰属表示

ほとんどの場合、場所の写真は帰属情報なしで使用できます。または、 画像の一部として必要な帰属情報が含まれます。ただし、 GMSPlacePhotoMetadata いずれかを含む attributions または authorAttribution、 必ず、これらの帰属表示を 説明します。詳しくは、次のドキュメントをご覧ください: アトリビューション。