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

Place Picker

Widget UI place-picker

Place-picker adalah widget UI bawaan yang sederhana namun fleksibel, bagian dari Google Places API for iOS.

Memperkenalkan place-picker

GMSPlacePicker menyediakan dialog UI yang menampilkan peta interaktif dan daftar tempat terdekat, termasuk tempat yang menyatakan alamat geografis dan bisnis setempat. Pengguna bisa memilih tempat, dan aplikasi Anda kemudian bisa menampilkan detail tempat yang dipilih.

Place-picker memberikan keuntungan berikut dibandingkan mengembangkan widget UI Anda sendiri:

  1. Pengalaman pengguna konsisten dengan aplikasi lain yang menggunakan place-picker, termasuk aplikasi Google dan aplikasi pihak ketiga. Ini berarti pengguna aplikasi Anda sudah tahu cara berinteraksi dengan place-picker.
  2. Peta telah terintegrasi ke dalam place-picker.
  3. Telah dilengkapi aksesibilitas.
  4. Menghemat waktu development.

Place picker menyediakan fungsionalitas pelengkapan otomatis, yang menampilkan prediksi tempat berdasarkan masukan penelusuran pengguna. Fungsionalitas ini terdapat di semua integrasi place picker, sehingga Anda tidak perlu melakukannya tindakan tambahan untuk mengaktifkan pelengkapan otomatis. Untuk informasi selengkapnya tentang pelengkapan otomatis, lihat Place Autocomplete.

Meminta otorisasi lokasi

Jika aplikasi Anda menggunakan place-picker, Anda harus meminta izin untuk menggunakan layanan lokasi. Pertama tambahkan salah satu atau kedua kunci berikut ke file Info.plist Anda, untuk meminta otorisasi 'bila digunakan' atau 'selalu':

  • NSLocationWhenInUseUsageDescription
  • NSLocationAlwaysUsageDescription

Untuk place picker, cukup meminta otorisasi 'bila digunakan', namun Anda mungkin perlu meminta otorisasi 'selalu' untuk fungsionalitas lain dalam aplikasi Anda. Untuk setiap kunci, tambahkan string yang memberi tahu pengguna mengapa mereka membutuhkan layanan lokasi. Misalnya:

<key>NSLocationWhenInUseUsageDescription</key>
<string>Show your location on the map</string>

Menambahkan place-picker

Cuplikan kode di bawah menampilkan cara membuat GMSPlacePicker yang berpusat di Sydney, dan detail keluaran dari tempat yang dipilih.

Swift

// The code snippet below shows how to create and display a GMSPlacePickerViewController.
@IBAction func pickPlace(_ sender: UIButton) {
  let config = GMSPlacePickerConfig(viewport: nil)
  let placePicker = GMSPlacePickerViewController(config: config)

  present(placePicker, animated: true, completion: nil)
}

// To receive the results from the place picker 'self' will need to conform to
// GMSPlacePickerViewControllerDelegate and implement this code.
func placePicker(_ viewController: GMSPlacePickerViewController, didPick place: GMSPlace) {
  // Dismiss the place picker, as it cannot dismiss itself.
  viewController.dismiss(animated: true, completion: nil)

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

func placePickerDidCancel(_ viewController: GMSPlacePickerViewController) {
  // Dismiss the place picker, as it cannot dismiss itself.
  viewController.dismiss(animated: true, completion: nil)

  print("No place selected")
}

Objective-C

// The code snippet below shows how to create and display a GMSPlacePickerViewController.
- (IBAction)pickPlace:(UIButton *)sender {
  GMSPlacePickerConfig *config = [[GMSPlacePickerConfig alloc] initWithViewport:nil];
  GMSPlacePickerViewController *placePicker =
    [[GMSPlacePickerViewController alloc] initWithConfig:config];
  placePicker.delegate = self;

  [self presentViewController:placePicker animated:YES completion:nil];
}

// To receive the results from the place picker 'self' will need to conform to
// GMSPlacePickerViewControllerDelegate and implement this code.
- (void)placePicker:(GMSPlacePickerViewController *)viewController didPickPlace:(GMSPlace *)place {
  // Dismiss the place picker, as it cannot dismiss itself.
  [viewController dismissViewControllerAnimated:YES completion:nil];

  NSLog(@"Place name %@", place.name);
  NSLog(@"Place address %@", place.formattedAddress);
  NSLog(@"Place attributions %@", place.attributions.string);
}

- (void)placePickerDidCancel:(GMSPlacePickerViewController *)viewController {
  // Dismiss the place picker, as it cannot dismiss itself.
  [viewController dismissViewControllerAnimated:YES completion:nil];

  NSLog(@"No place selected");
}

Seperti yang ditampilkan dalam contoh kode di atas, Anda bisa menginisialisasi place-picker dengan konfigurasi tertentu menggunakan objek GMSPlacePickerConfig. Dalam objek konfigurasi, tetapkan viewport berisi objek GMSCoordinateBounds yang menetapkan bidang persegi panjang pertama yang harus ditampilkan place-picker pada peta.

Panggil GMSPlacePicker.pickPlaceWithCallback(_:) untuk menampilkan dialog place picker yang meminta pengguna untuk memilih sebuah tempat.

Bila pengguna memilih sebuah tempat, aplikasi Anda akan menerima callback ke metode yang diberikan dalam pickPlaceWithCallback(_:). Callback ini dipanggil bersama tempat yang dipilih, atau nol jika pengguna tidak memilih sebuah tempat.

Menampilkan atribusi dalam aplikasi Anda

Bila aplikasi Anda menampilkan informasi yang diperoleh melalui place-picker, aplikasi juga harus menampilkan atribusi. Lihat dokumentasi mengenai atribusi.

Kirim masukan tentang...

location_on
Google Places API for iOS