Ringkasan Places SDK for Android (Legacy)

Produk ini dalam Status lama. Mulai Oktober 2026, Places API (Lama) tidak dapat lagi diaktifkan untuk project Google Cloud baru. Project yang ada tetap didukung sepenuhnya. Untuk fitur baru dan peningkatan performa, migrasikan ke Places API (New).

Gunakan panduan ini untuk memahami perbedaan utama antara versi Places SDK dan bermigrasi ke Places SDK for Android (New).

Fitur SDK yang tersedia di setiap versi

Tabel berikut menunjukkan versi SDK dan API yang diperlukan untuk setiap fitur SDK:

Fitur	Versi Places API	Metode inisialisasi	Versi SDK minimum
Autocomplete (New)	Places API (Baru)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Details (New)	Places API (Baru)	initializeWithNewPlacesApiEnabled()	3.3.0
Nearby Search (New)	Places API (Baru)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Photos (New)	Places API (Baru)	initializeWithNewPlacesApiEnabled()	3.4.0
Text Search (New)	Places API (Baru)	initializeWithNewPlacesApiEnabled()	3.3.0
Place Autocomplete	Places API (Lama)	initialize() (Tidak digunakan lagi)
Lokasi Saat Ini	Places API (Lama)	initialize() (Tidak digunakan lagi)
Place Details	Places API (Lama)	initialize() (Tidak digunakan lagi)
Place Photos	Places API (Lama)	initialize() (Tidak digunakan lagi)

Tidak digunakan lagi: Metode Places.initialize tidak digunakan lagi. Sebagai gantinya, gunakan Places.initializeWithNewPlacesApiEnabled(). Perhatikan bahwa untuk menggunakan Places.initializeWithNewPlacesApiEnabled(), Anda harus mengaktifkan Places API (New) pada kunci API Anda di Konsol Google Cloud.

Bermigrasi ke API baru

Untuk bermigrasi ke API baru, lihat panduan migrasi berikut:

• Bermigrasi ke Place Details (New)
• Bermigrasi ke Place Photos (New)
• Bermigrasi ke Autocomplete (New)

Peningkatan di Places SDK for Android (New)

Bagian ini membahas fitur utama yang ditambahkan ke Places SDK for Android (New).

Diimplementasikan di platform standar Google Cloud

Places SDK for Android (New) diimplementasikan di Service Infrastructure di Google Cloud. Implementasi ini menghadirkan platform yang lebih aman dan tepercaya. Desain standar ini menghadirkan tingkat konsistensi di seluruh SDK yang meningkatkan efisiensi pengembangan dengan Places SDK for Android (New).

Peningkatan performa

Places SDK for Android (New) memberikan peningkatan performa, sehingga layak untuk menggantikan aplikasi yang menggunakan SDK yang ada.

Fitur baru

Places SDK for Android (New) menyertakan versi terbaru dari semua fitur SDK:

• Autocomplete (New)
• Place Details (New)
• Nearby Search (New)
• Place Photos (New)
• Text Search (New)

Text Search (Baru)

Text Search (Baru) menampilkan informasi tentang serangkaian tempat berdasarkan suatu string — misalnya "pizza di Bandung" atau "toko sepatu di dekat Solo" atau "Jl. Rajawali 3". Layanan ini merespons dengan daftar tempat yang cocok dengan string teks dan bias lokasi yang telah ditetapkan.

Data respons baru ditambahkan ke Place Details (New) dan Place Photos (New)

• Place Details (Baru) kini menyertakan class Review baru dalam objek Place respons. Class Place berisi metode getReviews() baru untuk mendukung kolom ini. Panggil getReviews() untuk menampilkan hingga lima ulasan untuk suatu tempat.

• Foto Tempat (Baru) menambahkan AuthorAttributions ke class PhotoMetadata. AuthorAttributions berisi List objek AuthorAttribution.

Respons URI baru ditambahkan ke Foto Tempat (Baru)

Sekarang Anda dapat menggunakan Foto Tempat (Baru) untuk menampilkan URI ke bitmap gambar. Sebelumnya, Anda hanya dapat menampilkan bitmap gambar itu sendiri.

Penetapan harga yang disederhanakan

Harga disederhanakan dengan Places SDK for Android (New) sehingga Anda hanya membayar data yang digunakan. Penetapan harga yang disederhanakan diterapkan menggunakan daftar kolom, yang juga disebut mask kolom.

Dengan Place Details (Baru) dan Text Search (Baru), Anda menggunakan daftar kolom untuk mengontrol daftar kolom yang akan ditampilkan dalam respons. Kemudian, Anda hanya akan ditagih untuk data yang diminta. Penggunaan daftar kolom merupakan praktik desain yang baik untuk memastikan Anda tidak meminta data yang tidak diperlukan. Cara ini akan membantu Anda menghindari waktu pemrosesan dan biaya penagihan yang tidak perlu.

Untuk mengetahui informasi harga selengkapnya, lihat Penggunaan dan penagihan.

Jenis tempat yang diperluas

SDK baru menyertakan jenis tempat baru, yang ditampilkan sebagai bagian dari respons Place Details (Baru) dan Text Search (Baru). Anda juga dapat menggunakan jenis baru ini, dan jenis yang ada, dalam penelusuran dengan Text Search (New). Jenis baru disertakan dalam Tabel A.