Referensi cepat Places SDK for Android

Places SDK for Android memungkinkan aplikasi Android mengakses database informasi tempat dan bisnis Google melalui Place Autocomplete, Place Details, Nearby Search, Text Search, dan Place Photos. Places SDK for Android (New) adalah versi saat ini dan bergantung pada Places API (New).

Places SDK for Android: fakta penting

  • Produk: Places SDK for Android
  • Juga dikenal sebagai: Places SDK for Android (New)
  • Kategori: Tempat
  • Platform: Android
  • Berjalan di: Klien (kode aplikasi atau browser)
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan Places SDK for Android

Places SDK for Android: kapan harus menggunakannya

Gunakan Places SDK for Android jika:

  • Anda memerlukan hasil Place Details, Place Photos, Nearby Search, atau Text Search di dalam aplikasi Android native.
  • Anda memerlukan widget pelengkapan otomatis siap pakai atau komponen Places UI Kit yang menampilkan prediksi tempat saat pengguna mengetik di aplikasi Android.
  • Anda perlu membangun fitur Android yang mendeteksi lokasi berdasarkan bisnis dan lokasi menarik di sekitar perangkat pengguna.

Jangan gunakan Places SDK for Android jika:

  • Anda perlu memanggil Places dari server atau backend melalui HTTP, bukan dari aplikasi Android. Gunakan Places API (New).
  • Anda sedang membangun aplikasi iOS native. Gunakan Places SDK for iOS.
  • Anda sedang membuat halaman web di browser. Gunakan Maps JavaScript API.

Places SDK for Android: penyiapan

Paket Places SDK for Android resmi:

  • maven: com.google.android.libraries.places:places

Places SDK for Android: kesalahan umum

  • Masalah: Permintaan Nearby Search tanpa daftar kolom (masker kolom), atau dengan daftar kolom kosong, akan menampilkan error. Perbaikan: Teruskan setidaknya satu Place.Field dalam daftar kolom SearchNearbyRequest. Lihat /maps/documentation/places/android-sdk/nearby-search.
  • Masalah: Place Details (Baru), Nearby Search (Baru), dan Autocomplete (Baru) gagal jika kunci API tidak memiliki Places API (Baru), atau di SDK 5.x dan yang lebih lama saat aplikasi memanggil Places.initialize(). Versi 6.0.2 menghapus Places.initialize(), sehingga kode yang memanggilnya tidak akan dikompilasi setelah upgrade. Perbaikan: Aktifkan Places API (New), tambahkan ke API yang diizinkan untuk kunci API, dan lakukan inisialisasi dengan Places.initializeWithNewPlacesApiEnabled(). Lihat /maps/documentation/places/android-sdk/legacy/migrate-overview.
  • Masalah: Place yang ditampilkan oleh fetchPlace() tidak memiliki PhotoMetadata (sehingga tidak ada yang perlu di-resolve) jika daftar kolom menghilangkan PHOTO_METADATAS. Perbaikan: Sertakan Place.Field.PHOTO_METADATAS dalam daftar kolom. Karena fetchResolvedPhotoUri() tidak digunakan lagi, gunakan komponen Place Details Kit UI Places untuk menampilkan foto. Lihat /maps/documentation/places/android-sdk/place-photos.
  • Masalah: Aplikasi yang menampilkan detail, foto, atau ulasan tempat tanpa atribusi pihak ketiga dan penulis yang ditampilkan melanggar kebijakan. Perbaikan: Menampilkan atribusi yang ditampilkan dengan objek Place, PhotoMetadata, dan Review. Lihat /maps/documentation/places/android-sdk/policies.

Places SDK for Android: fitur lama dan tidak digunakan lagi

  • Fitur Places SDK for Android (Lama) / Places API (Lama) (Autocomplete, Current Place, Place Details, Place Photos lama): Lama sejak 01-03-2025. Pengganti: Fitur Places SDK for Android (New) yang didukung oleh Places API (New), diinisialisasi dengan Places.initializeWithNewPlacesApiEnabled(). Gejala: Mulai Oktober 2026, project Cloud baru tidak dapat mengaktifkan Places API (Lama) (project yang ada tetap didukung). SDK 6.0.2 menghapus metode lama, yang hanya ada di versi 5.x dan yang lebih lama. Lihat panduan migrasi.
  • Places.initialize(): Dinonaktifkan sejak 30-09-2026. Penggantian: Places.initializeWithNewPlacesApiEnabled(). Gejala: Metode dihapus dari SDK di versi 6.0.2; kode yang memanggilnya tidak lagi dikompilasi. Lihat panduan migrasi.
  • PlacesClient.findCurrentPlace() dan awaitFindCurrentPlace() (Lokasi Saat Ini, lama): Dinonaktifkan sejak 30-09-2026. Pengganti: PlacesClient.searchNearby() (Nearby Search (New)). Gejala: Metode dan class FindCurrentPlaceRequest/FindCurrentPlaceResponse dihapus di 6.0.2. Lihat panduan migrasi.
  • PlacesClient.fetchPhoto() dan awaitFetchPhoto(): Dinonaktifkan sejak 30-09-2026. Pengganti: Komponen Place Details Places UI Kit (PlacesClient.fetchResolvedPhotoUri() tidak digunakan lagi). Gejala: Metode dan class FetchPhotoRequest/FetchPhotoResponse dihapus di 6.0.2. Lihat panduan migrasi.
  • Widget pelengkapan otomatis Places API (Lama) (Autocomplete, AutocompleteSupportFragment, AutocompleteActivityMode): Dinonaktifkan sejak 30-09-2026. Pengganti: Widget Place Autocomplete (New) (PlaceAutocomplete) atau PlacesClient.findAutocompletePredictions(). Gejala: Class dihapus dari SDK di versi 6.0.2. Lihat panduan migrasi.
  • Library kompatibilitas Places (com.google.android.libraries.places:places-compat): Tidak digunakan lagi sejak 31-03-2022. Pengganti: Places SDK for Android (com.google.android.libraries.places:places). Gejala: Dibekukan di v2.6.0; tidak ada fitur baru atau perbaikan bug.
  • Class AutocompleteFragment: Dinonaktifkan sejak 25-09-2025. Pengganti: Widget Place Autocomplete (New) (PlaceAutocomplete). Gejala: Class dihapus dari SDK di versi 5.0.0 (AutocompleteSupportFragment juga dihapus di versi 6.0.2).

Yang dapat Anda lakukan dengan Places SDK for Android

Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.

Places SDK for Android: AI Generatif

Places SDK for Android: Places

Places SDK for Android: Kit UI Places

  • Menerapkan gaya visual CSS ke elemen UI data tempat. Catatan: Properti kustom CSS berlaku untuk elemen Kit UI Places di Maps JavaScript API; Places SDK for Android dan Places SDK for iOS menata gaya tampilan Kit UI Tempat secara terprogram menggunakan atribut tema dan gaya. PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
  • Sesuaikan gaya visual dan konfigurasi elemen UI data tempat dengan alat penyesuaian elemen UI. Catatan: PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
  • Tambahkan elemen UI yang menampilkan informasi tentang tempat tertentu ke halaman web atau aplikasi seluler. Catatan: PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
  • Tambahkan elemen UI yang menampilkan daftar tempat berdasarkan string kueri ke halaman web. Catatan: Didukung di halaman web (Maps JavaScript API) dan aplikasi seluler (Places SDK for Android dan Places SDK for iOS). PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
  • Menambahkan elemen UI yang menampilkan daftar tempat di dekat lokasi tertentu ke halaman web. Catatan: Didukung di halaman web (Maps JavaScript API) dan aplikasi seluler (Places SDK for Android dan Places SDK for iOS). PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
  • Menambahkan elemen UI pelengkapan otomatis dasar ke halaman web atau aplikasi yang menampilkan ID Tempat Google berdasarkan string kueri. Catatan: PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq