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
が含まれている場合は、画像を表示するすべての場所に、これらのアトリビューションを含める必要があります。詳しくは、アトリビューションに関するドキュメントをご覧ください。