場所の写真(新規)

プラットフォームを選択: Android iOS ウェブサービス

Places SDK for iOS(新規)を使用すると、アプリに表示するプレイスフォトをリクエストできます。フォトサービスで返される写真のソースは、お店やサービスの所有者、ユーザーが投稿した写真など、さまざまです。

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

画像をリクエストする

1 つの場所に対してリクエストできる写真は 10 枚までです。

  1. プレイス ID と GMSPlacePhotoMetadataResultCallback コールバックを渡して [GMSPlacesClient lookUpPhotosForPlaceID] を呼び出します。このリクエストは、GMSPlacePhotoMetadataList オブジェクトを使用して GMSPlacePhotoMetadataResultCallback コールバックを呼び出します。

  2. コールバックの GMSPlacePhotoMetadataList オブジェクトの results 配列プロパティには写真が含まれます。各写真は GMSPlacePhotoMetadata オブジェクトで表されます。

  3. GMSPlacePhotoMetadata オブジェクトを使用して、リクエストされた画像の最大サイズを含む GMSFetchPhotoRequest を作成します。

  4. 配列内の各 GMSPlacePhotoMetadata オブジェクトについて、GMSFetchPhotoRequest オブジェクトを渡して [GMSPlacesClient fetchPhotoWithRequest:callback:] を呼び出します。このメソッドは、使用可能なビットマップ画像を UIImage として渡す GMSFetchPhotoResultCallback コールバックを呼び出します。

場所の写真をリクエストする別の方法として、フィールドリストに GMSPlacePropertyPhotos を含めて Place Details (New) リクエストを実行することもできます。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
    }
  }];
}];

iOS 向け Places Swift SDK(プレビュー)

// 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:] を使用して読み込まれたフォトは、共有の NSURLCacheFoundation URL ローディング システムによって、ディスク上とメモリ内の両方にキャッシュされます。

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

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

帰属表示

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