Pilih versi SDK Anda

Fitur Places SDK for Android yang tersedia di aplikasi Anda adalah ditentukan oleh kombinasi nomor versi SDK (mis. 3.5.0) yang Anda menentukan dalam konfigurasi aplikasi Anda, API yang diaktifkan pada kunci API, dan bagaimana Anda melakukan inisialisasi aplikasi Anda. 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 di build.gradle level aplikasi menentukan apakah aplikasi 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 informasi selengkapnya tentang perubahan yang diperkenalkan di setiap versi SDK, lihat Tempat Rilis SDK for Android catatan.

Versi Places API untuk Places SDK for Android

Selain menentukan nomor versi SDK, Anda juga harus memilih opsi Places Layanan API yang dipanggil SDK di Google Cloud Console: Places API atau Places API (Baru). Bersama dengan nomor versi SDK, layanan API yang {i>select<i} menentukan versi fitur tertentu yang tersedia di aplikasi Anda, seperti Autocomplete atau Autocomplete (New). Meskipun Anda hanya dapat menentukan satu SDK Anda dapat mengaktifkan Places API dan Places API (Baru) di kunci API secara bersamaan, lalu pilih layanan yang dipanggil SDK metode yang digunakan untuk menginisialisasi SDK di aplikasi Anda. Namun, dalam kebanyakan kasus, Anda mungkin ingin mengaktifkan Places API (Baru) dan menggunakan versi (Baru) dari fitur SDK di aplikasi Anda.

Memilih versi SDK dan layanan API

Untuk memilih fitur SDK yang tersedia di aplikasi Anda, lakukan hal berikut:

  1. Di project Google Cloud Anda, aktifkan Places API, Places API (Baru), atau keduanya. Untuk informasi selengkapnya, lihat Mengaktifkan API
  2. Dalam pembatasan kunci API Anda, aktifkan Places API, Places API (Baru), atau keduanya. Untuk informasi selengkapnya, lihat Membatasi API .

  3. Di file build.gradle level aplikasi, tentukan nomor versi. Untuk selengkapnya informasi, lihat Penginstalan.

  4. Inisialisasi aplikasi Anda dengan memanggil metode Places.initializeWithNewPlacesApiEnabled() atau Places.initialize() .

Untuk informasi selengkapnya tentang 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 SDK fitur:

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, kemudian mulai 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 fitur ini penyempurnaan Places SDK for Android (Baru), Anda harus menggunakan SDK. Tidak perlu migrasi saat beralih ke SDK baru, cukup ikuti langkah-langkah di Memilih versi SDK dan API layanan Google.
  • Di Places SDK for Android (Baru), token sesi tersedia mulai di versi 3.5.0. Untuk informasi selengkapnya, lihat Sesi token.
  • Panggilan yang dilakukan menggunakan widget Place Autocomplete selalu memanggil Place Pelengkapan otomatis, bukan Place Autocomplete (Baru); tidak terpengaruh oleh metode inisialisasi.
  • Foto Tempat (Baru) hanya menampilkan URI ke gambar bitmap, sedangkan Place Foto hanya menampilkan bitmap gambar.
  • Current Place adalah 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) diterapkan pada layanan infrastruktur dan aplikasi yang dihosting 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).

Peningkatan performa

Places SDK for Android (Baru) memberikan performa yang lebih baik, sehingga lebih berguna untuk mengganti aplikasi yang menggunakan SDK yang ada.

Fitur baru

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

Layanan Text Search baru

Text Search (Baru) menampilkan informasi tentang kumpulan tempat berdasarkan suatu string — misalnya "pizza di Bandung" atau "toko sepatu di dekat Solo" atau "123 Main Street". Layanan ini merespons dengan membuat daftar tempat yang cocok dengan {i>string <i}teks dan bias lokasi yang telah ditetapkan.

Data respons baru ditambahkan ke Placed Details (Baru) dan Place Photos (Baru)

  • Detail Tempat (Baru) kini mencakup Tinjau dalam objek Place respons. Tujuan Class Place berisi metode getReviews() baru untuk mendukung kolom ini. Telepon getReviews() untuk menampilkan hingga lima ulasan untuk suatu tempat.

  • Foto Tempat (Baru) menambahkan AuthorAttributions ke class PhotoMetadata. AuthorAttributions berisi List dari AuthorAttribution objek terstruktur dalam jumlah besar.

Respons URI baru ditambahkan ke Place Photos (Baru)

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

Penetapan harga yang disederhanakan

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

Dengan Place Details dan Penelusuran Teks menggunakan daftar bidang untuk mengontrol daftar yang akan ditampilkan dalam respons. Anda kemudian hanya ditagih untuk data diminta. Menggunakan daftar {i>field<i} adalah praktik desain yang baik untuk memastikan bahwa Anda tidak permintaan data yang tidak perlu, yang membantu menghindari waktu pemrosesan yang tidak perlu dan biaya penagihan.

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-jenis ini ditampilkan sebagai bagian dari Place Details dan Respons Text Search. Anda juga dapat menggunakan tipe baru ini, dan jenis yang ada, dalam penelusuran dengan Text Search. Jenis baru tersebut disertakan dalam Tabel J.

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 taman bermain 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, Anda sekarang dapat menggunakan jenis ini sebagai bagian dari cari:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality