Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Places API for Android

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 Android
  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 Android.

Memperkenalkan place-picker

PlacePicker 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.

Izin

Jika aplikasi Anda menggunakan place-picker, Anda harus meminta izin ACCESS_FINE_LOCATION.

Model perizinan baru di Android 6.0 Marshmallow

Android 6.0 (Marshmallow) memperkenalkan model baru untuk menangani izin, yang mengefisienkan proses memasang dan meningkatkan versi aplikasi bagi pengguna. Asalkan Anda menggunakan Google Play Services versi 8.1 atau yang lebih baru, Anda bisa mengonfigurasi aplikasi untuk menargetkan Android 6.0 Marshmallow SDK dan menggunakan model izin baru.

Jika aplikasi Anda mendukung model izin baru, pengguna tidak perlu memberikan izin saat memasang atau meningkatkan versi aplikasi. Sebagai gantinya, aplikasi harus meminta izin bila membutuhkannya pada waktu proses, dan sistem akan menampilkan dialog untuk meminta izin kepada pengguna.

Untuk mengetahui selengkapnya, lihat dokumentasi Android 6.0 Marshmallow dan perubahan yang harus Anda buat pada aplikasi untuk model izin baru tersebut.

Menambahkan place-picker

Inilah rangkuman langkah-langkah yang diperlukan untuk menjalankan place-picker:

  1. Gunakan PlacePicker.IntentBuilder() untuk membangun suatu Intent.
  2. Jika ingin mengubah perilaku default place picker, Anda bisa menggunakan builder untuk menyetel batas awal garis lintang dan garis bujur pada peta yang ditampilkan oleh place-picker. Panggil setLatLngBounds() pada builder, dengan meneruskan LatLngBounds untuk menyetel batas awal garis lintang dan garis bujur. Batas ini mendefinisikan area yang disebut 'viewport'. Secara default, viewport berada di tengah lokasi perangkat, dengan perbesaran hingga tingkat blok-kota.
  3. Panggil startActivityForResult(), dengan meneruskan maksud dan kode permintaan yang telah didefinisikan, sehingga Anda bisa mengidentifikasi permintaan bila hasilnya dikembalikan.

Cuplikan kode berikut menjalankan place-picker:

int PLACE_PICKER_REQUEST = 1;
PlacePicker.IntentBuilder builder = new PlacePicker.IntentBuilder();

startActivityForResult(builder.build(this), PLACE_PICKER_REQUEST);

Bila pengguna memilih tempat, Anda bisa mengambil tempat dengan memanggil PlacePicker.getPlace(). Jika pengguna belum memilih tempat, metode akan mengembalikan nol.

Anda juga bisa menampilkan batas terbaru peta dengan memanggil PlacePicker.getLatLngBounds().

Cuplikan kode berikut menampilkan tempat yang telah dipilih pengguna:

protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  if (requestCode == PLACE_PICKER_REQUEST) {
    if (resultCode == RESULT_OK) {
        Place place = PlacePicker.getPlace(data, this);
        String toastMsg = String.format("Place: %s", place.getName());
        Toast.makeText(this, toastMsg, Toast.LENGTH_LONG).show();
    }
  }
}

Menyetel warna khusus menggunakan tema bahan

Jika Anda menyetel warna khusus dalam aplikasi menggunakan tema bahan, place-picker akan mewarisi atribut colorPrimary dan colorPrimaryDark dari tema tersebut. Hal ini berguna untuk mempertahankan merek yang konsisten di seluruh aplikasi Anda dan place-picker.

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 Android