Places API mendukung dua versi API: Places API adalah API yang ada dan Places API (Baru) adalah yang berikutnya yang baru dari API.
Dengan dirilisnya Places API (Baru), tugas pertama Anda adalah memutuskan sekumpulan API yang akan digunakan. Hal ini berlaku jika Anda adalah pelanggan baru atau lama yang sudah menggunakan API. Gunakan panduan ini untuk memahami kunci perbedaan antara kedua API tersebut.
Daftar API
Tabel berikut mencantumkan kedua set API. Jika Anda adalah pelanggan lama, gunakan tabel ini untuk menentukan API baru yang menggantikan API yang yang digunakan saat ini.
| Places API | Places API (Baru) | Catatan |
|---|---|---|
| Find Place | Penelusuran Teks (Baru) | Tidak ada versi baru Find Place. Text Search (Baru) telah menggantikannya. |
| Penelusuran Di Sekitar | Nearby Search (Baru) | Semua permintaan yang menggunakan API yang sudah ada dan menyertakan kueri teks harus menggunakan Penelusuran Teks (Baru) karena Nearby Search (Baru) tidak mendukung input teks. |
| Penelusuran Teks | Penelusuran Teks (Baru) | |
| Detail Tempat | Place Details (Baru) | |
| Foto Tempat | Foto Tempat (Baru) | |
| Pelengkapan Otomatis Tempat | Pelengkapan Otomatis (Baru) | |
| Pelengkapan Otomatis Kueri | Pelengkapan Otomatis (Baru) | Kemampuan yang ditambahkan ke Autocomplete (Baru) |
Versi layanan Places API yang Anda aktifkan di kunci API Anda mengontrol API yang digunakan oleh aplikasi Anda:
Places API: Mengaktifkan API yang sudah ada. Jika saja Places API 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 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 keduanya Places SDK for iOS (Baru) dan Places SDK for iOS.
Untuk informasi selengkapnya tentang 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:
- Bermigrasi ke Nearby Search (Baru)
- Bermigrasi ke Text Search (Baru)
- Bermigrasi ke Place Details (Baru)
- Bermigrasi ke Place Photo (Baru)
- Bermigrasi ke Autocomplete (Baru)
Fitur utama yang ditambahkan ke Places API (Baru)
Bagian ini membahas fitur utama yang ditambahkan ke Places API (Baru).
Diterapkan pada platform standar Google Cloud
Places API (Baru) diimplementasikan pada infrastruktur layanan dan aplikasi yang dihosting di Google Cloud. Implementasi ini menghadirkan pengalaman yang lebih aman dan tepercaya platform lengkap dengan opsi keamanan yang ditingkatkan seperti OAuth. API standar ini menghadirkan tingkat konsistensi di seluruh API yang meningkatkan efisiensi pengembangan dengan Places API (Baru).
Peningkatan performa
Places API (Baru) memberikan performa yang lebih baik, sehingga perlu mengganti aplikasi yang menggunakan Places API yang ada.
Penetapan harga yang disederhanakan
Penetapan harga disederhanakan dengan Places API (Baru) sehingga Anda hanya membayar data yang Anda gunakan. 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 untuk ditampilkan dalam respons. Anda kemudian hanya ditagih untuk data diminta. Menggunakan penyamaran kolom adalah praktik desain yang baik untuk memastikan bahwa Anda tidak meminta data yang tidak perlu, yang membantu menghindari waktu pemrosesan yang tidak perlu dan biaya penagihan.
Data respons yang konsisten untuk suatu tempat
Dengan API yang ada, Place Details, Nearby Search, dan Text Search API menampilkan data respons yang berbeda untuk suatu tempat. Places API (Baru) menstandarkan respons sehingga semua API ini mengembalikan data yang sama untuk suatu tempat.
Jenis tempat yang diperluas
Respons API kini dapat berisi jenis utama tempat. Setiap tempat dapat memiliki nilai tipe tunggal yang ditetapkan sebagai tipe utama tempat, seperti yang tercantum dalam Tabel A.
Selain itu, API baru menambahkan jenis tempat yang ditampilkan pada tabel di bawah. Anda dapat menggunakan tipe baru ini, dan tipe yang ada, dalam pencarian dengan Nearby Search (Baru) dan Text Search (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 | 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
Data tempat dinamis
Places API (Baru) mendukung data respons dinamis, seperti ketersediaan stasiun pengisian kendaraan listrik umum atau harga bahan bakar terbaru untuk SPBU. Gunakan isian respons ini untuk menciptakan 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 mulai menggunakan Places API, kemudian mulai dengan API baru.
Jika Anda adalah pelanggan baru dan belum ada pengganti untuk yang ada, seperti Place Autocomplete atau Query Pelengkapan Otomatis, maka Anda dapat menggunakan kombinasi API baru dan yang sudah ada.
Jika Anda pelanggan lama, Anda dapat terus menggunakan versi lama Google Cloud Platform. Namun, untuk memanfaatkan peningkatan kinerja dan penyempurnaan fitur Places API (Baru), Anda dapat bermigrasi ke API baru.
Untuk informasi selengkapnya tentang migrasi, lihat Migrasi ringkasan.