Fitur Places SDK for iOS yang tersedia di aplikasi Anda ditentukan oleh kombinasi nomor versi SDK (misalnya, 9.0.0) yang Anda tentukan dalam dependensi paket dan API yang diaktifkan di kunci API Anda. Panduan ini menjelaskan perbedaan antarversi dan cara memilih versi yang diaktifkan di aplikasi Anda.
Nomor versi SDK
Nomor versi SDK yang Anda tentukan dalam dependensi paket menentukan apakah aplikasi Anda memiliki akses ke fitur yang ditambahkan dalam rilis tertentu. Misalnya, Autocomplete (Baru) hanya tersedia di SDK versi 9.0.0 atau yang lebih baru.
Untuk mengetahui informasi selengkapnya tentang perubahan yang diperkenalkan di setiap versi SDK, lihat catatan rilis Places SDK for iOS.
Versi Places API untuk Places SDK for iOS
Selain menentukan nomor versi SDK, Anda juga harus memilih layanan Places API yang dipanggil SDK di Google Cloud Console: Places API atau Places API (Baru). Bersama dengan nomor versi SDK, layanan API yang Anda pilih menentukan versi fitur tertentu yang tersedia di aplikasi Anda, seperti Autocomplete atau Autocomplete (New). Meskipun Anda hanya dapat menentukan satu nomor versi SDK, Anda dapat mengaktifkan Places API dan Places API (Baru) di kunci API Anda secara bersamaan. Namun, dalam sebagian besar kasus, Anda sebaiknya mengaktifkan Places API (Baru) dan menggunakan fitur SDK versi (Baru) di aplikasi Anda.
Pilih versi SDK dan layanan API Anda
Untuk memilih fitur SDK yang tersedia di aplikasi Anda, lakukan hal berikut:
- Di project Google Cloud, aktifkan Places API, Places API (Baru), atau keduanya. Untuk informasi selengkapnya, lihat Mengaktifkan API
- Di pembatasan kunci API, aktifkan Places API, Places API (Baru), atau keduanya. Untuk mengetahui informasi selengkapnya, lihat Membatasi kunci API.
- Saat menginstal SDK, tentukan nomor versi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan project Xcode.
Untuk informasi selengkapnya tentang cara memilih layanan Places API, lihat Menyiapkan project Google Cloud.
Fitur SDK yang tersedia di setiap versi
Tabel berikut menunjukkan versi SDK dan API yang diperlukan untuk setiap fitur SDK:
| Places SDK for iOS (Baru) | Versi SDK Minimum | Places SDK for iOS | Versi SDK Minimum |
|---|---|---|---|
| Place Details (Baru) | 9.0.0 | Place Details | 3.0.0 |
| Place Photo (Baru) | 9.0.0 | Place Photo | 3.0.0 |
| Penelusuran Teks (Baru) | 8.5.0 | ||
| Nearby Search (Baru) | 9.0.0 | ||
| Pelengkapan Otomatis (Baru) | 9.0.0 | Pelengkapan Otomatis | 3.0.0 |
| Current Place | 3.0.0 |
Pertimbangan untuk memilih versi yang akan diaktifkan
- Jika Anda adalah pelanggan baru yang baru saja memulai Places SDK for iOS, mulailah dengan Places API (Baru) dan SDK baru.
- Jika Anda adalah pelanggan lama, Anda dapat terus menggunakan SDK yang ada. Namun, untuk memanfaatkan peningkatan performa dan peningkatan fitur Places SDK for iOS (Baru), Anda harus mengaktifkan Places API (Baru) dan menggunakan SDK baru. Tidak perlu migrasi saat beralih ke SDK baru, cukup ikuti langkah-langkah di Memilih versi SDK dan layanan API.
- Places API (Baru) tidak mengaktifkan beberapa fitur
yang ada seperti Current
Place,
GMSPlace.isOpen, danGMSPlace.isOpenAtDate.
Menggunakan Places Swift SDK for iOS (Pratinjau)
Langkah-langkah berikut diperlukan untuk menggunakan Places Swift SDK for iOS (Pratinjau):
- Aktifkan Places API (Baru).
- Tambahkan Places Swift SDK for iOS (Preview) ke dependensi Anda.
- Lakukan inisialisasi klien Places dengan
PlacesClient.
Untuk mempelajari Places Swift SDK for iOS (Pratinjau) lebih lanjut, tinjau ringkasan atau panduan migrasi.
Bermigrasi ke API baru
Jika Anda menggunakan API yang sudah ada dan ingin bermigrasi ke API baru, lihat panduan migrasi berikut untuk setiap API:
Peningkatan di Places SDK for iOS (Baru)
Bagian ini membahas fitur utama yang ditambahkan ke Places SDK for iOS (Baru).
Diimplementasikan di platform standar Google Cloud
Places SDK for iOS (Baru) diimplementasikan di 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 iOS (Baru).
Peningkatan performa
Places SDK for iOS (Baru) memberikan performa yang lebih baik, sehingga aplikasi yang menggunakan SDK yang ada akan diganti.
Fitur baru
Places SDK for iOS (Baru) menyertakan versi terbaru dari semua fitur SDK:
- Pelengkapan Otomatis (Baru)
- Place Details (Baru)
- Nearby Search (Baru)
- Place Photos (Baru)
- Penelusuran Teks (Baru)
Penetapan harga yang disederhanakan
Harga disederhanakan dengan Places SDK for iOS (Baru) sehingga Anda hanya membayar data yang digunakan. Penetapan harga yang disederhanakan diterapkan menggunakan daftar kolom, yang juga disebut mask kolom.
Dengan Places SDK for iOS dan Text Search, Anda menggunakan daftar kolom untuk mengontrol daftar kolom yang akan ditampilkan dalam respons. Kemudian, Anda hanya 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 bagi 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 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 | penjahit |
| 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, Anda kini dapat menggunakan jenis ini sebagai bagian dari penelusuran:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality