Pilih versi SDK Anda

Places SDK for iOS versi 8.5.0 mendukung dua versi SDK: Places SDK for iOS adalah Places SDK for iOS (Baru) yang sudah ada yang merupakan SDK versi generasi berikutnya.

Dengan dirilisnya Places SDK for iOS versi 8.5.0, tugas pertama Anda adalah memutuskan SDK yang akan digunakan. Hal ini berlaku jika Anda pelanggan baru atau pelanggan lama yang sudah menggunakan SDK ini. Gunakan panduan ini untuk memahami perbedaan utama antara kedua SDK.

Cara memilih versi SDK

Places SDK for iOS bergantung pada layanan Places API. Sebelum dapat menggunakan Places SDK for iOS, Anda harus mengaktifkan layanan Places API di project Google Cloud.

Versi layanan Places API yang Anda aktifkan akan mengontrol versi SDK yang digunakan oleh aplikasi Anda:

  • Places API: Mengaktifkan Places SDK for iOS yang ada. Jika hanya Places API yang diaktifkan untuk project yang terkait dengan kunci API yang digunakan untuk aplikasi Anda, aplikasi Anda tidak akan memiliki akses ke fitur baru yang ditambahkan di Places SDK for iOS versi 8.5.0 dan yang lebih baru.

  • Places API (Baru): Mengaktifkan Places SDK for iOS (Baru) termasuk Text Search dan semua fitur baru yang dijelaskan dalam Fitur utama yang ditambahkan ke Places SDK for iOS (Baru). Tidak mengaktifkan fitur yang ada seperti Place Details, Place Photos, Current Place, dan Place Autocomplete.

  • Keduanya: Mengaktifkan semua fitur untuk Places SDK for iOS (Baru) dan Places SDK for iOS.

Untuk mengetahui informasi selengkapnya tentang cara memilih layanan Places API, lihat Menyiapkan project Google Cloud.

SDK mana yang Anda pilih?

Untuk membantu memutuskan versi yang harus dipilih:

  1. Jika Anda adalah pelanggan baru yang baru mulai menggunakan Places SDK for iOS, mulailah dengan Places API (Baru) dan Places API agar Anda memiliki akses ke semua fitur.

  2. Jika Anda adalah pelanggan lama, Anda dapat terus menggunakan SDK yang sudah ada. Namun, untuk memanfaatkan peningkatan performa dan peningkatan fitur Places SDK for iOS (Baru), Anda dapat menggunakan SDK baru.

    Migrasi tidak diperlukan saat berpindah ke SDK baru. Anda hanya perlu mengaktifkan Places SDK for iOS (Baru) di kunci API yang digunakan di aplikasi Anda. Jika Anda menggunakan Places SDK for iOS dan Places SDK for iOS (Baru) yang sudah ada, aktifkan kedua versi tersebut di kunci API Anda. Untuk informasi selengkapnya, lihat Menggunakan Kunci API.

Fitur utama ditambahkan ke Places SDK for iOS (Baru)

Bagian ini membahas fitur utama yang ditambahkan ke Places SDK for iOS (Baru).

Diterapkan di platform standar Google Cloud

Places SDK for iOS (Baru) diterapkan 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).

Performa meningkat

Places SDK for iOS (Baru) memberikan performa yang lebih baik, sehingga penggantian aplikasi yang menggunakan SDK yang ada akan bermanfaat.

Text Search 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.

Penetapan harga yang disederhanakan

Harga disederhanakan dengan Places SDK for iOS (Baru) sehingga Anda hanya membayar untuk data yang Anda gunakan. 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. Selanjutnya, Anda hanya akan ditagih untuk data yang diminta. Penggunaan daftar kolom merupakan praktik desain yang baik untuk memastikan Anda tidak meminta data yang tidak perlu, yang akan membantu 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 sudah ada, dalam penelusuran dengan Text Search. Jenis baru ini 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 B dari Tabel A. Artinya, Anda kini dapat menggunakan jenis ini sebagai bagian dari penelusuran:
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality