Places SDK for iOS(新規)を使用すると、アプリに表示するプレイスフォトをリクエストできます。フォトサービスで返される写真のソースは、お店やサービスの所有者、ユーザーが投稿した写真など、さまざまです。
写真は、UIImage オブジェクトで表されるビットマップ画像です。ビットマップ画像の最大サイズは 4,800 x 4,800 ピクセルです。
画像をリクエストする
1 つの場所に対してリクエストできる写真は 10 枚までです。
プレイス ID と
GMSPlacePhotoMetadataResultCallback
コールバックを渡して[GMSPlacesClient lookUpPhotosForPlaceID]
を呼び出します。このリクエストは、GMSPlacePhotoMetadataList
オブジェクトを使用してGMSPlacePhotoMetadataResultCallback
コールバックを呼び出します。コールバックの
GMSPlacePhotoMetadataList
オブジェクトのresults
配列プロパティには写真が含まれます。各写真はGMSPlacePhotoMetadata
オブジェクトで表されます。GMSPlacePhotoMetadata
オブジェクトを使用して、リクエストされた画像の最大サイズを含むGMSFetchPhotoRequest
を作成します。配列内の各
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:]
を使用して読み込まれたフォトは、共有の NSURLCache
の Foundation URL ローディング システムによって、ディスク上とメモリ内の両方にキャッシュされます。
キャッシュの動作を設定するには、アプリ デリゲートの application:didFinishLaunchingWithOptions:
メソッドで [NSURLCache setSharedURLCache:]
を使用して、共有 URL キャッシュを変更します。
アプリケーションで NSURLCache
を Places SDK for iOS と共有したくない場合は、新しい NSURLCache
を作成し、共有キャッシュとして設定せずにこれをアプリ内で独占的に使用できます。
帰属表示
ほとんどの場合、プレイスの写真は属性情報なしで使用できます。それ以外の場合は、画像の一部として必要な属性情報が含まれています。ただし、返された GMSPlacePhotoMetadata
インスタンスに attributions
または authorAttribution
が含まれている場合は、画像を表示するたびにアプリケーションにその帰属情報を含める必要があります。アトリビューションに関するドキュメントをご覧ください。