プレイス写真への移行（新規）

Places SDK for iOS は、既存のプレイスの写真をサポートしています。既存の Place Photo をご存じであれば、新しいバージョンの Place Photo では次のような変更が加えられています。

  • 新しい料金モデルを使用します。すべての API の料金については、Places SDK for iOS の料金（新規）をご覧ください。

  • 既存の Place Photo では、最大写真サイズが 1,600 x 1,600 ピクセルでした。Place Photo（新規）は、最大 4,800×4,800 ピクセルのサイズをサポートしています。

  • リクエストを送信するには、新しい GMSPlacesClient fetchPhotoWithRequest:callback: メソッドを呼び出します。

  • リクエストに渡します。

  • 各写真は GMSPlacePhotoMetadata インスタンスで表されます。Places SDK for iOS（新規）の GMSPlacePhotoMetadata インスタンスには、新しい GMSPlaceAuthorAttribution クラスで表される新しい authorAttribution フィールドが含まれています。

    返された GMSPlacePhotoMetadata インスタンスに attributions または authorAttribution が含まれている場合は、画像を表示するすべての箇所で、これらの帰属情報をアプリケーションに含める必要があります。アトリビューションに関するドキュメントをご覧ください。

リクエスト例

次のメソッドの例では、プレイス 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
    }
  }];
}];