Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Places API for iOS

Untuk membantu Anda memulai, kami akan memandu Anda melalui Google Developers Console untuk melakukan beberapa hal terlebih dahulu:

  1. Buat atau pilih sebuah proyek
  2. Aktifkan Google Places API for iOS
  3. Buat kunci yang sesuai
Lanjutkan

ID Tempat dan Detail

Google Places API for iOS memberikan informasi lengkap pada aplikasi Anda mengenai tempat, termasuk nama dan alamat tempat, lokasi geografis yang ditetapkan sebagai koordinat garis lintang/garis bujur, tipe tempat (seperti klub malam, toko hewan peliharaan, museum), dan lainnya. Untuk mengakses informasi ini bagi tempat tertentu, Anda bisa menggunakan ID tempat, yakni identifier stabil yang secara unik mengidentifikasi tempat.

Place Details

Kelas GMSPlace memberikan informasi tentang tempat tertentu. Anda bisa mendapatkan objek GMSPlace dengan cara berikut:

Kelas GMSPlace memberikan informasi berikut:

  • name – Nama tempat.
  • placeID – Identifier tekstual untuk tempat tersebut. Baca selengkapnya tentang ID tempat di bagian selebihnya laman ini.
  • coordinate – Lokasi geografis sebuah tempat, ditetapkan berupa koordinat garis lintang dan garis bujur.
  • openNowStatus – Menunjukkan apakah tempat tersebut buka pada saat permintaan informasi tempat dibuat.
  • phoneNumber – Nomor telepon tempat, dalam format internasional.
  • formattedAddress – Alamat tempat, dalam format yang bisa dibaca orang.
  • rating – Kumpulan peringkat tempat ini, dikembalikan berupa nilai mengambang yang berkisar dari 1,0 hingga 5,0, berdasarkan gabungan ulasan pengguna.
  • priceLevel – Tingkat harga untuk tempat ini, dikembalikan berupa integer dengan nilai berkisar dari 0 (termurah) hingga 4 (paling mahal).
  • types – Daftar tipe tempat yang mencirikan tempat ini. Lihat dokumentasi tipe yang didukung.
  • website – URI situs web tempat ini, jika diketahui. Ini adalah situs web yang dikelola oleh bisnis atau entitas lain yang berkaitan dengan tempat tersebut.
  • attributionsNSAttributedString berisi atribusi yang harus Anda tampilkan kepada pengguna jika aplikasi Anda menggunakan detail tempat yang diperoleh dari Google Places API for iOS. Untuk detail tentang mengambil dan menampilkan atribusi, lihat panduan atribusi.
  • addressComponents – Sebuah larik dari objek GMSAddressComponent yang merepresentasikan komponen alamat untuk sebuah tempat. Komponen ini disediakan untuk mengambil informasi terstruktur tentang alamat sebuah tempat, misalnya menemukan kota yang menjadi lokasi sebuah tempat. Jangan gunakan komponen ini untuk pemformatan alamat; sebagai gantinya, gunakan properti formattedAddress, yang menyediakan alamat yang diformat dan sudah dilokalkan.

Mendapatkan tempat melalui ID

ID tempat adalah identifier tekstual yang secara unik mengidentifikasi tempat. Dalam Google Places API for iOS, Anda bisa mengambil ID tempat dari objek GMSPlace. Anda bisa menyimpan ID tempat dan menggunakannya untuk mengambil lagi objek GMSPlace nanti.

Untuk mendapatkan tempat melalui ID, panggil GMSPlacesClient lookUpPlaceID:callback:, dengan meneruskan ID tempat dan metode callback.

API akan memanggil metode callback yang ditetapkan, dengan meneruskan objek GMSPlace. Jika tempat tidak ditemukan, objek tempat akan nol.

Swift

// A hotel in Saigon with an attribution.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

placesClient.lookUpPlaceID(placeID, callback: { (place, error) -> Void in
  if let error = error {
    print("lookup place id query error: \(error.localizedDescription)")
    return
  }

  guard let place = place else {
    print("No place details for \(placeID)")
    return
  }

  print("Place name \(place.name)")
  print("Place address \(place.formattedAddress)")
  print("Place placeID \(place.placeID)")
  print("Place attributions \(place.attributions)")
})

Objective-C

// A hotel in Saigon with an attribution.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

[_placesClient lookUpPlaceID:placeID callback:^(GMSPlace *place, NSError *error) {
  if (error != nil) {
    NSLog(@"Place Details error %@", [error localizedDescription]);
    return;
  }

  if (place != nil) {
    NSLog(@"Place name %@", place.name);
    NSLog(@"Place address %@", place.formattedAddress);
    NSLog(@"Place placeID %@", place.placeID);
    NSLog(@"Place attributions %@", place.attributions);
  } else {
    NSLog(@"No place details for %@", placeID);
  }
}];

Menampilkan atribusi dalam aplikasi Anda

Bila aplikasi Anda menampilkan informasi yang diperoleh dari GMSPlacesClient lookUpPlaceID:callback:, aplikasi juga harus menampilkan atribusi. Lihat dokumentasi mengenai atribusi.

Selengkapnya tentang ID tempat

ID tempat yang digunakan di Google Places API for iOS adalah identifier yang sama seperti yang digunakan di Google Places API Web Service, Google Places API for Android dan Google API lainnya.

Setiap ID tempat bisa merujuk ke satu tempat saja, namun satu tempat bisa memiliki lebih dari satu ID tempat. Kasus yang paling umum untuk menangani multi-ID sebuah tempat adalah bila Anda telah menambahkan tempat yang awalnya dalam cakupan aplikasi Anda, lalu menerima cakupan berskala Google.

Ada keadaan lain yang mungkin menyebabkan suatu tempat mendapatkan ID tempat baru. Misalnya, hal ini bisa terjadi jika bisnis pindah ke lokasi baru.

Bila Anda meminta sebuah tempat dengan menetapkan ID tempat, Anda bisa yakin akan selalu menerima tempat yang sama dalam respons (jika tempat itu masih ada). Akan tetapi, perlu diketahui bahwa respons itu mungkin berisi ID tempat yang berbeda dari yang Anda minta.

Untuk informasi selengkapnya, lihat ringkasan ID tempat.

Kirim masukan tentang...

location_on
Google Places API for iOS