このページは Cloud Translation API によって翻訳されました。

場所の写真（新規）

Places SDK for iOS（新版）を使用すると、アプリケーションで写真を表示するようリクエストできます。写真サービスから返される写真は、ビジネスオーナーやユーザーが投稿した写真など、さまざまなソースから返されます。

写真は、UIImage オブジェクトで表されるビットマップ画像です。ビットマップ画像の最大サイズは 4,800 x 4,800 ピクセルです。

画像をリクエストする

1 か所につき最大 10 枚の写真をリクエストできます。

[GMSPlacesClient lookUpPhotosForPlaceID] を呼び出し、プレイス ID と GMSPlacePhotoMetadataResultCallback コールバックを渡します。このリクエストは、GMSPlacePhotoMetadataList オブジェクトを指定して GMSPlacePhotoMetadataResultCallback コールバックを呼び出します。
コールバックの GMSPlacePhotoMetadataList オブジェクトから、results 配列プロパティには写真が含まれ、それぞれの写真は GMSPlacePhotoMetadata オブジェクトで表されます。
配列内の GMSPlacePhotoMetadata オブジェクトごとに、[GMSPlacesClient loadPlacePhoto:callback:] または [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:] を呼び出します。これらのメソッドは、UIImage として使用可能なビットマップ画像とともにコールバックを呼び出します。

場所の写真をリクエストするもう 1 つの方法は、Place Details (New) リクエストを行うことです。フィールドリストに 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 = photos.first else { return }

  // Request individual photos in the response list
  let fetchPhotoRequest = GMSFetchPhotoRequest(metadata: photoMetadata, maxSize: CGSizeMake(4800, 4800)
  placesClient.fetchPhoto(fetchPhotoRequest: fetchPhotoRequest, callback: {
    (photoURL: URL?, error: Error?) in
      guard let photoURL, error == nil else { return }
      print("Photo URL: \(photoURL)")
  })
};

Objective-C

// A hotel in Saigon with an attribution.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

[placesClient lookUpPhotosForPlaceID:placeID callback: (GMSPlacePhotoMetadataList *list, NSError *error) {
  GMSPlacePhotoMetadata *photoMetadata = [list firstObject];

  if (photoMetadata == nil) { return }

  // Request individual photos in the response list
  GMSFetchPhotoRequest *fetchPhotoRequest = [[GMSFetchPhotoRequest alloc] initWithPhotoMetadata:photoMetadata maxSize:CGSizeMake(4800, 4800)];
  [placesClient fetchPhoto:fetchPhotoRequest, callback: ^(NSURL *_Nullable photoURL, NSError *_Nullable error) {
    if (error == null) {
      NSLog(@"Photo URL: %@", photoURL)
    }
  }];
}];

GooglePlacesSwift

// 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 の基盤 URL 読み込みシステムによってディスクとメモリ内の両方にキャッシュに保存されます。

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

アプリケーションで NSURLCache を Places SDK for iOS と共有したくない場合は、新しい NSURLCache を作成し、共有キャッシュとして設定せずに、アプリ内でのみこれを使用できます。

帰属表示

ほとんどの場合、場所の写真は帰属情報なしで使用できます。または、必要な帰属情報を画像の一部として含めます。ただし、返された GMSPlacePhotoMetadata インスタンスに attributions または authorAttribution が含まれている場合は、画像を表示するすべての場所に、これらのアトリビューションを含める必要があります。詳しくは、アトリビューションに関するドキュメントをご覧ください。