Places API mendukung dua versi API: Places API adalah API yang ada dan Places API (Baru) adalah versi generasi berikutnya dari API.
Dengan rilis Places API (Baru), tugas pertama Anda adalah menentukan kumpulan API mana yang akan digunakan. Hal ini berlaku jika Anda adalah pelanggan baru atau pelanggan lama yang sudah menggunakan API. Gunakan panduan ini untuk memahami perbedaan utama antara kedua API.
Daftar API
Tabel berikut mencantumkan kedua kumpulan API tersebut. Jika Anda adalah pelanggan lama, gunakan tabel ini untuk menentukan API baru yang menggantikan API yang saat ini Anda gunakan.
| Places API | Places API (Baru) | Catatan |
|---|---|---|
| Find Place | Penelusuran Teks (Baru) | Tidak ada versi baru Find Place. Text Search (Baru) telah menggantikannya. |
| Penelusuran Langsung | Nearby Search (Baru) | Semua permintaan yang menggunakan API yang ada dan menyertakan kueri teks harus menggunakan Text Search (New) karena Nearby Search (New) tidak mendukung input teks. |
| Text Search | Penelusuran Teks (Baru) | |
| Place Details | Place Details (Baru) | |
| Place Photo | Place Photo (Baru) | |
| Place Autocomplete | Pelengkapan Otomatis (Baru) | |
| Query Autocomplete | Pelengkapan Otomatis (Baru) | Kemampuan yang ditambahkan ke Pelengkapan Otomatis (Baru) |
Versi layanan Places API yang Anda aktifkan di kunci API akan mengontrol API yang digunakan oleh aplikasi Anda:
Places API: Mengaktifkan API 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 API baru.
Places API (Baru): Mengaktifkan semua API dan fitur baru yang dijelaskan dalam Fitur utama yang ditambahkan ke Places SDK for iOS (Baru). Aplikasi Anda tidak akan memiliki akses ke API yang ada.
Keduanya: Mengaktifkan semua fitur dan API 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.
Bermigrasi ke API baru
Jika Anda menggunakan API yang sudah ada dan ingin bermigrasi ke API baru, lihat panduan migrasi berikut untuk setiap API:
- Migrasi ke Penelusuran Langsung (Baru)
- Bermigrasi ke Text Search (Baru)
- Bermigrasi ke Place Details (Baru)
- Bermigrasi ke Place Photo (Baru)
- Migrasi ke Autocomplete (Baru)
Fitur utama yang ditambahkan ke Places API (Baru)
Bagian ini membahas fitur utama yang ditambahkan ke Places API (Baru).
Diimplementasikan di platform standar Google Cloud
Places API (Baru) diterapkan di infrastruktur layanan di Google Cloud. Penerapan ini menghadirkan platform yang lebih aman dan tepercaya dengan opsi keamanan yang ditingkatkan seperti OAuth. Desain API standar ini memberikan tingkat konsistensi di seluruh API yang meningkatkan efisiensi pengembangan dengan Places API (Baru).
Peningkatan performa
Places API (Baru) memberikan performa yang lebih baik, sehingga aplikasi yang menggunakan Places API yang ada akan lebih baik jika diganti.
Penetapan harga yang disederhanakan
Harga disederhanakan dengan Places API (Baru) sehingga Anda hanya membayar data yang digunakan. Penetapan harga yang disederhanakan diterapkan menggunakan mask kolom.
Dengan Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru), Anda menggunakan mask kolom untuk mengontrol daftar kolom yang akan ditampilkan dalam respons. Kemudian, Anda hanya ditagih untuk data yang diminta. Penggunaan penyamaran 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.
Data respons yang konsisten untuk suatu tempat
Dengan API yang ada, API Place Details, Nearby Search, dan Text Search menampilkan data respons yang berbeda untuk suatu tempat. Places API (Baru) menstandarkan respons sehingga semua API ini menampilkan data yang sama untuk suatu tempat.
Jenis tempat yang diperluas
Respons API kini dapat berisi jenis utama tempat. Setiap tempat dapat memiliki satu nilai jenis yang ditentukan sebagai jenis utama tempat, seperti yang tercantum dalam Tabel A.
Selain itu, API baru ini menambahkan jenis tempat yang ditampilkan dalam tabel di bawah. Anda dapat menggunakan jenis baru ini, dan jenis yang sudah ada, dalam penelusuran dengan Penelusuran Langsung (Baru) dan Penelusuran Teks (Baru). Semua 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
Data tempat dinamis
Places API (Baru) mendukung data respons dinamis, seperti ketersediaan SPLU kendaraan listrik atau harga bahan bakar terbaru untuk SPBU. Gunakan kolom respons ini untuk membuat pengalaman pengguna yang dinamis.
API mana yang Anda pilih?
Sebelum dapat memulai pengembangan aplikasi, Anda harus memilih API:
Jika Anda adalah pelanggan baru yang baru saja memulai Places API, mulailah dengan API baru.
Jika Anda adalah pelanggan baru dan belum ada pengganti untuk API yang ada, seperti Place Autocomplete atau Query Autocomplete, Anda dapat menggunakan kombinasi API baru dan lama.
Jika Anda adalah pelanggan lama, Anda dapat terus menggunakan API yang ada. Namun, untuk memanfaatkan peningkatan performa dan peningkatan fitur Places API (Baru), Anda dapat bermigrasi ke API baru.
Untuk informasi selengkapnya tentang migrasi, lihat Ringkasan migrasi.