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

Places SDK for iOS は、既存の Place Photo をサポートしています。既存の Place Photo を使い慣れている方は、新バージョンの Place Photo で次のように変更されています。

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

  • 既存の Place Photo は 1,600 x 1,600 ピクセルの写真サイズまでサポートしていました。Place Photo（新版）は最大 4,800 x 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
    }
  }];
}];