Fitur Places SDK for iOS yang tersedia di aplikasi ditentukan oleh kombinasi nomor versi SDK (mis. 9.0.0) yang yang Anda tentukan dalam dependensi paket dan API yang diaktifkan pada kunci API. Panduan ini menjelaskan perbedaan berbagai versi dan cara memilih versi yang sesuai 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 di rilis tertentu. Misalnya, Autocomplete (Baru) hanya tersedia di SDK versi 9.0.0 atau yang lebih baru.
Untuk informasi selengkapnya tentang perubahan yang diperkenalkan di setiap versi SDK, lihat Tempat Catatan rilis SDK for iOS.
Versi Places API untuk Places SDK for iOS
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. Namun, dalam sebagian besar kasus, Anda perlu mengaktifkan Places API (Baru) dan gunakan 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 API .
- Saat menginstal SDK, tentukan nomor versi. Untuk informasi selengkapnya, lihat Menyiapkan project Xcode.
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 | Versi SDK minimum |
|---|---|---|
| Pelengkapan Otomatis (Baru) | Places API (Baru) | 9.0.0 |
| Place Details (Baru) | Places API (Baru) | 9.0.0 |
| Nearby Search (Baru) | Places API (Baru) | 9.0.0 |
| Foto Tempat (Baru) | Places API (Baru) | 9.0.0 |
| Penelusuran Teks (Baru) | Places API (Baru) | 8.5.0 |
| Pelengkapan Otomatis Tempat | Places API | 3.0.0 |
| Current Place | Places API | 3.0.0 |
| Detail Tempat | Places API | 3.0.0 |
| Foto Tempat | Places API | 3.0.0 |
Pertimbangan untuk memilih versi yang akan diaktifkan
- Jika Anda adalah pelanggan baru yang baru mulai menggunakan Places SDK for iOS, 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 penyempurnaan Places SDK for iOS (Baru), Anda harus mengaktifkan Places API (Baru) dan gunakan SDK baru. Tidak ada migrasi yang diperlukan saat berpindah ke SDK yang baru, cukup ikuti langkah-langkah di Memilih versi SDK dan API layanan Google.
- Places API (Baru) tidak mengaktifkan beberapa yang sudah ada
fitur seperti Current/
Tempat,
GMSPlace.isOpendanGMSPlaceisOpenAtDate
Menggunakan rilis Pratinjau GooglePlacesSwift
Langkah-langkah berikut diperlukan untuk menggunakan GooglePlacesSwift:
- Mengaktifkan Places API (Baru).
- Tambahkan GooglePlacesSwiftSDK pada dependensi Anda.
- Melakukan inisialisasi klien Places dengan
PlacesClient
Untuk mempelajari GooglePlacesSwift lebih lanjut, tinjau referensi dokumentasi tambahan.
Bermigrasi ke API baru
Jika Anda menggunakan API yang sudah ada dan ingin bermigrasi ke API baru, lihat panduan migrasi berikut untuk setiap API:
- Bermigrasi ke Place Details (Baru)
- Bermigrasi ke Place Photo (Baru)
- Bermigrasi ke Autocomplete (Baru)
Peningkatan di Places SDK for iOS (Baru)
Bagian ini membahas fitur utama yang ditambahkan ke Places SDK for iOS (Baru).
Diterapkan pada platform standar Google Cloud
Places SDK for iOS (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 iOS (Baru).
Peningkatan performa
Places SDK for iOS (Baru) memberikan performa yang lebih baik, sehingga sebaiknya Anda mengganti aplikasi yang menggunakan SDK yang ada.
Fitur baru
Places SDK for iOS (Baru) menyertakan versi terbaru dari semua fitur SDK:
- Pelengkapan Otomatis (Baru)
- Place Details (Baru)
- Nearby Search (Baru)
- Foto Tempat (Baru)
- Penelusuran Teks (Baru)
Penetapan harga yang disederhanakan
Penetapan harga disederhanakan dengan Places SDK for iOS (Baru) sehingga Anda hanya membayar untuk data yang Anda gunakan. Penetapan harga yang disederhanakan diterapkan menggunakan kolom daftar, juga disebut mask kolom.
Dengan Places SDK for iOS 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:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality