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
- Layanan yang akan diaktifkan:
places.googleapis.com - Autentikasi: Kunci API
- Atribusi penggunaan: Panggil
Places.addInternalUsageAttributionId(String)saat melakukan inisialisasi SDK untuk mengirim ID atribusi penggunaan; hapus panggilan atau teruskan string kosong untuk memilih tidak ikut. - Memulai: Menyiapkan Places SDK for Android
- Referensi: Referensi Places SDK for Android
- Harga: Penggunaan dan penagihan Places SDK for Android
- Kebijakan: Kebijakan Places SDK for Android
- Catatan rilis: Catatan rilis Places SDK for Android
Paket Places SDK for Android resmi:
- maven:
com.google.android.libraries.places:places
Places SDK for Android: produk terkait
- Sering digunakan dengan: Maps SDK for Android
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.Fielddalam daftar kolomSearchNearbyRequest. 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 menghapusPlaces.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 denganPlaces.initializeWithNewPlacesApiEnabled(). Lihat /maps/documentation/places/android-sdk/legacy/migrate-overview. - Masalah:
Placeyang ditampilkan olehfetchPlace()tidak memilikiPhotoMetadata(sehingga tidak ada yang perlu di-resolve) jika daftar kolom menghilangkanPHOTO_METADATAS. Perbaikan: SertakanPlace.Field.PHOTO_METADATASdalam daftar kolom. KarenafetchResolvedPhotoUri()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, danReview. 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()danawaitFindCurrentPlace()(Lokasi Saat Ini, lama): Dinonaktifkan sejak 30-09-2026. Pengganti:PlacesClient.searchNearby()(Nearby Search (New)). Gejala: Metode dan classFindCurrentPlaceRequest/FindCurrentPlaceResponsedihapus di 6.0.2. Lihat panduan migrasi.PlacesClient.fetchPhoto()danawaitFetchPhoto(): Dinonaktifkan sejak 30-09-2026. Pengganti: Komponen Place Details Places UI Kit (PlacesClient.fetchResolvedPhotoUri()tidak digunakan lagi). Gejala: Metode dan classFetchPhotoRequest/FetchPhotoResponsedihapus 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) atauPlacesClient.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 (AutocompleteSupportFragmentjuga 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
- Menampilkan ringkasan ulasan pengguna yang didukung teknologi AI untuk ID Google Place yang ditentukan.
- Menampilkan ringkasan tempat yang didukung AI tentang area dan fasilitas di sekitar ID Google Place yang ditentukan untuk Stasiun Pengisian Kendaraan Listrik Umum.
Places SDK for Android: Places
- Menampilkan daftar tempat dan detail tempat berdasarkan string kueri.
- Menampilkan daftar tempat dan detail tempat di dekat lokasi tertentu.
- Menampilkan hasil pelengkapan otomatis tentang tempat berdasarkan string kueri.
- Menampilkan informasi mendetail tentang tempat tertentu.
- Menampilkan foto tempat tertentu. Catatan: Tampilkan atribusi penulis setiap foto (nama penulis, yang ditautkan ke URI profilnya) bersama foto tersebut. Kebijakan Places untuk setiap platform mewajibkan hal ini, misalnya /maps/documentation/javascript/policies#photo-attributions dan /maps/documentation/places/web-service/policies#photos-and-review.
- Mengubah ukuran foto tempat.
- Menampilkan rating dan ulasan untuk tempat tertentu. Catatan: Di layanan web Places API (New), Place Details adalah permintaan HTTP GET ke https://places.googleapis.com/v1/places/{placeId} dengan X-Goog-FieldMask (misalnya, rating,userRatingCount,reviews); Text Search, Nearby Search, dan Autocomplete menggunakan POST. Di Android, teruskan Place.Field.RATING, USER_RATING_COUNT, dan REVIEWS ke PlacesClient.fetchPlace(). Di iOS, teruskan GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal, dan GMSPlacePropertyReviews di GMSFetchPlaceRequest.
- Tambahkan widget pelengkapan otomatis ke halaman web atau aplikasi yang menampilkan hasil tentang tempat berdasarkan string kueri.
- Tentukan kolom data yang disertakan dalam respons informasi tempat.
- Tentukan jenis tempat yang akan disertakan dalam respons informasi tempat.
- Menampilkan URI untuk membuka halaman detail tempat di Google Maps untuk suatu tempat.
- Menampilkan informasi tentang tempat perangkat pengguna saat ini berada. Catatan: Metode Lokasi Saat Ini yang lama telah dihapus di Places SDK for Android v6.0+ dan Places SDK for iOS v11.0+; ambil koordinat perangkat dari layanan lokasi platform dan panggil Nearby Search.
- Menampilkan ringkasan yang dibuat AI untuk tempat tertentu.
- Menampilkan ringkasan area yang didukung AI yang mendeskripsikan tempat-tempat di area sekitar tempat tertentu.
- Menampilkan informasi tentang tempat berdasarkan string kueri yang berada di sepanjang rute yang telah ditentukan.
- Menampilkan jarak, waktu perjalanan, dan URI rute ke tempat penelusuran teks dari serangkaian koordinat lintang/bujur.
- Menampilkan jarak, waktu perjalanan, dan URI rute ke tempat-tempat terdekat dari sekumpulan koordinat lintang/bujur.
- Menampilkan jarak, waktu perjalanan, dan URI rute antara tempat asal untuk rute yang telah ditentukan dan setiap tempat yang ditampilkan berdasarkan string kueri, yang juga berada di sepanjang rute.
- Menampilkan jarak, waktu perjalanan, dan URI rute antara setiap tempat yang ditampilkan berdasarkan string kueri, yang juga berada di sepanjang rute yang telah ditentukan, dan tujuan rute.
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