Fitur Places SDK for Android yang tersedia di aplikasi Anda ditentukan oleh kombinasi nomor versi SDK (misalnya 3.5.0) yang Anda tentukan dalam konfigurasi aplikasi, API yang diaktifkan pada kunci API, dan cara Anda menginisialisasi aplikasi. Panduan ini menjelaskan perbedaan antara berbagai versi dan cara memilih versi yang diaktifkan di aplikasi Anda.
Nomor versi SDK
Nomor versi SDK yang Anda tentukan dalam file build.gradle level aplikasi menentukan apakah aplikasi Anda memiliki akses ke fitur yang ditambahkan dalam rilis tertentu. Misalnya, Autocomplete (Baru) hanya tersedia di SDK versi 3.5.0 atau yang lebih baru.
Untuk mengetahui informasi selengkapnya tentang perubahan yang diperkenalkan di setiap versi SDK, lihat catatan rilis Places SDK for Android.
Versi Places API untuk Places SDK for Android
Selain menentukan nomor versi SDK, Anda juga harus memilih layanan Places API yang dipanggil SDK di Konsol Google Cloud: Places API atau Places API (Baru). Bersama dengan nomor versi SDK, layanan API yang Anda pilih akan menentukan versi fitur spesifik yang tersedia di aplikasi Anda, seperti Autocomplete atau Autocomplete (Baru). Meskipun hanya dapat menentukan satu nomor versi SDK, Anda dapat mengaktifkan Places API dan Places API (Baru) pada kunci API secara bersamaan, lalu memilih layanan mana yang dipanggil SDK melalui metode yang Anda gunakan untuk menginisialisasi SDK di aplikasi Anda. Namun, dalam sebagian besar kasus, Anda perlu mengaktifkan Places API (Baru) dan menggunakan versi (Baru) fitur SDK di aplikasi Anda.
Memilih versi SDK dan layanan API
Untuk memilih fitur SDK yang tersedia di aplikasi Anda, lakukan hal berikut:
- Di project Google Cloud Anda, aktifkan Places API, Places API (Baru), atau keduanya. Untuk informasi selengkapnya, lihat Mengaktifkan API
- Dalam pembatasan kunci API Anda, aktifkan Places API, Places API (Baru), atau keduanya. Untuk informasi selengkapnya, lihat Membatasi kunci API.
Di file build.gradle level aplikasi, tentukan nomor versi. Untuk mengetahui informasi selengkapnya, lihat Penginstalan.
Inisialisasi aplikasi Anda dengan memanggil metode
Places.initializeWithNewPlacesApiEnabled()
atauPlaces.initialize()
.
Untuk informasi selengkapnya tentang cara memilih layanan Places API, lihat Menyiapkan project Google Cloud Anda.
Fitur SDK yang tersedia di setiap versi
Tabel berikut menunjukkan versi SDK dan API yang diperlukan untuk setiap fitur SDK:
Fitur | Places API diaktifkan pada kunci API | Metode inisialisasi | Versi SDK minimum |
---|---|---|---|
Pelengkapan Otomatis (Baru) | Places API (Baru) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
Place Details (Baru) | Places API (Baru) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
Nearby Search (Baru) | Places API (Baru) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
Foto Tempat (Baru) | Places API (Baru) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
Penelusuran Teks (Baru) | Places API (Baru) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
Pelengkapan Otomatis Tempat | Places API | initialize() |
|
Current Place | Places API | initialize() |
|
Detail Tempat | Places API | initialize() |
|
Foto Tempat | Places API | initialize() |
Pertimbangan untuk memilih versi yang akan diaktifkan
Untuk membantu memutuskan versi yang akan dipilih, pertimbangkan hal berikut:
- Jika Anda adalah pelanggan baru yang baru mulai menggunakan Places SDK for Android, mulailah dengan Places API (Baru) dan SDK baru.
- Jika Anda sudah menjadi pelanggan, Anda dapat terus menggunakan SDK yang sudah ada. Namun, untuk memanfaatkan peningkatan performa dan peningkatan fitur Places SDK for Android (Baru), Anda harus menggunakan SDK baru. Tidak ada migrasi yang diperlukan saat berpindah ke SDK baru. Cukup ikuti langkah-langkah di Memilih versi SDK dan layanan API.
- Di Places SDK for Android (Baru), token sesi tersedia mulai versi 3.5.0. Untuk informasi selengkapnya, lihat Token sesi.
- Panggilan yang dilakukan menggunakan widget Place Autocomplete selalu memanggil Place Autocomplete, bukan Place Autocomplete (Baru); panggilan widget tidak terpengaruh oleh metode inisialisasi.
- Foto Tempat (Baru) hanya menampilkan URI ke gambar bitmap, sedangkan Foto Tempat hanya menampilkan gambar bitmap.
- Current Place hanya tersedia di Places SDK for Android, bukan Places SDK for Android (Baru).
Peningkatan di Places SDK for Android (Baru)
Bagian ini membahas fitur utama yang ditambahkan ke Places SDK for Android (Baru).
Diterapkan pada platform standar Google Cloud
Places SDK for Android (Baru) diimplementasikan pada infrastruktur layanan 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 (Baru).
Performa meningkat
Places SDK for Android (Baru) memberikan performa yang lebih baik, sehingga Anda perlu mengganti aplikasi yang menggunakan SDK yang ada.
Fitur baru
Places SDK for Android (Baru) menyertakan versi terbaru dari semua fitur SDK:
- Pelengkapan Otomatis (Baru)
- Place Details (Baru)
- Nearby Search (Baru)
- Foto Tempat (Baru)
- Penelusuran Teks (Baru)
Layanan 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 Placed Details (Baru) dan Place Photos (Baru)
Place Details (Baru) kini menyertakan class Review baru dalam objek
Place
respons. Class Place berisi metodegetReviews()
baru untuk mendukung kolom ini. PanggilgetReviews()
untuk menampilkan hingga lima ulasan untuk suatu tempat.Place Photo (Baru) menambahkan
AuthorAttributions
ke classPhotoMetadata
.AuthorAttributions
berisiList
dari objekAuthorAttribution
.
Respons URI baru ditambahkan ke Place Photos (Baru)
Sekarang Anda dapat menggunakan Place Photo (Baru) untuk menampilkan URI ke bitmap gambar. Sebelumnya, Anda hanya dapat menampilkan bitmap gambar itu sendiri.
Penetapan harga yang disederhanakan
Penetapan harga disederhanakan dengan Places SDK for Android (Baru) sehingga Anda hanya membayar untuk data yang Anda gunakan. Penetapan harga yang disederhanakan diterapkan menggunakan daftar kolom, juga disebut mask kolom.
Dengan Place Details dan Text Search, Anda menggunakan daftar kolom untuk mengontrol daftar kolom yang akan ditampilkan dalam respons. 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 informasi harga mendetail untuk kedua SDK, lihat Penggunaan dan Penagihan.
Jenis tempat yang diperluas
SDK baru menambahkan jenis tempat yang ditampilkan dalam tabel berikut. Jenis ini ditampilkan sebagai bagian dari respons Place Details dan Text Search. Anda juga dapat menggunakan jenis baru ini, dan jenis yang ada, dalam penelusuran dengan Text Search. Jenis baru tersebut disertakan dalam Tabel A.
Jenis | |||
---|---|---|---|
american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
amusement_center | dog_park | indian_restaurant | school_district |
athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
auto_parts_store | event_venue | italian_restaurant | ski_resort |
banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
barbecue_restaurant | farm | korean_restaurant | sporting_goods_store |
barber_shop | Farmstay | lebanese_restaurant | sports_club |
bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
brazilian_restaurant | ferry_terminal | pasar | steak_house |
breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
bus_stop | gift_shop | mexican_restaurant | sesuaikan |
camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
cell_phone_store | greek_restaurant | motel | thai_restaurant |
child_care_agency | grocery_store | national_park | transit_depot |
chinese_restaurant | guest_house | park_and_ride | truck_stop |
coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
konsultan | Heliport | playground | vegetarian_restaurant |
convention_center | hiking_area | prasekolah | vietnamese_restaurant |
pondok | historical_landmark | private_guest_room | visitor_center |
courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
cultural_center | hostel | resort_hotel | grosir |
dental_clinic | hotel | rest_stop |
Bersama dengan jenis baru ini, Places API (Baru) memindahkan jenis berikut dari Tabel 2 untuk Places API ke Tabel A untuk Places API (Baru). Artinya, sekarang Anda dapat menggunakan jenis berikut sebagai bagian dari penelusuran:
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality