Migrasi ke Foto Tempat (Baru)

Fitur ini mengharuskan Anda mengaktifkan Places API (Baru), Places API generasi berikutnya. Untuk informasi selengkapnya, lihat Mengaktifkan API.

Places SDK for iOS mendukung Foto Tempat yang ada. Jika Anda sudah terbiasa dengan Foto Tempat yang ada, Foto Tempat versi baru akan membuat perubahan berikut:

• Menggunakan model harga baru. Untuk informasi harga semua API, lihat Harga untuk Places SDK for iOS (Baru).

• Place Photo yang ada mendukung ukuran foto maksimum 1.600x1.600 piksel. Foto Tempat (Baru) mendukung ukuran hingga 4.800x4.800 piksel.

• Untuk membuat permintaan, panggil metode GMSPlacesClient fetchPhotoWithRequest:callback: baru.

• Teruskan ke permintaan:

  • Instance class GMSFetchPhotoRequest baru yang menentukan semua parameter permintaan, termasuk ukuran gambar maksimum.

  • Callback jenis GMSPlacePhotoMetadataResultCallback untuk menangani respons.

• Setiap foto direpresentasikan oleh instance GMSPlacePhotoMetadata. Untuk Places SDK for iOS (Baru), instance GMSPlacePhotoMetadata berisi kolom authorAttribution baru yang direpresentasikan oleh class GMSPlaceAuthorAttribution baru.

  Jika instance GMSPlacePhotoMetadata yang ditampilkan menyertakan attributions atau authorAttribution, Anda harus menyertakan atribusi ini dalam aplikasi di mana pun Anda menampilkan gambar. Lihat dokumentasi tentang atribusi.

Contoh permintaan

Metode contoh berikut mengambil ID tempat dan mendapatkan foto pertama dalam daftar yang ditampilkan. Anda dapat menggunakan metode ini sebagai template untuk metode yang akan Anda buat di aplikasi Anda sendiri.

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
    }
  }];
}];