Pengantar
Places API (Baru) memberikan performa yang lebih baik dan model harga baru, sehingga aplikasi yang menggunakan Places API (Lama) sebaiknya diupdate. Untuk mengetahui detail selengkapnya tentang perbandingan fitur, lihat Memilih API.
Gunakan panduan ini untuk memahami perbedaan utama antara Places API (Baru) dibandingkan dengan Places API (Lama), beserta cara menangani perubahan yang diperlukan.
Praktik terbaik penagihan untuk migrasi
Panduan ini berlaku jika penggunaan API Anda cukup tinggi untuk beralih ke harga tingkat kedua. Saat bermigrasi ke versi API yang lebih baru, Anda juga akan ditagih untuk SKU yang berbeda. Untuk menghindari peningkatan biaya selama bulan transisi, sebaiknya alihkan ke API baru dalam produksi sedekat mungkin dengan awal bulan. Hal ini akan memastikan Anda mencapai tingkat harga bulanan yang paling hemat biaya selama bulan migrasi. Untuk mengetahui informasi tentang tingkat harga, lihat halaman harga dan FAQ harga.
Mengaktifkan Places API (Baru)
Untuk menggunakan fitur Places API (Baru), Anda harus mengaktifkan Places API (Baru) terlebih dahulu di project Google Cloud Anda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan project Google Cloud.
Kemudian, Anda harus memastikan bahwa Anda telah menambahkan Places API (Baru) ke kunci API yang digunakan oleh aplikasi Anda. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Kunci API.
Perubahan umum
Beberapa perubahan umum yang berlaku untuk beberapa API mencakup:
- Semua API baru mendukung kunci API dan token OAuth sebagai mekanisme autentikasi.
- Hanya JSON yang didukung sebagai format respons.
- Masking kolom diperlukan oleh Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru) untuk menentukan kolom mana yang ingin Anda tampilkan dalam respons. Untuk mengetahui informasi selengkapnya, lihat FieldMask.
- API Nearby Search (Baru) dan Text Search (Baru) kini menampilkan detail tempat lengkap agar sesuai dengan detail tempat yang ditampilkan oleh Place Details (Baru).
- Format respons JSON untuk API Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru) telah berubah dari format API yang ada. Untuk mengetahui detail selengkapnya, lihat bagian Memigrasikan respons Places API.
Perubahan khusus API
Bagian ini mencakup panduan migrasi berikut untuk setiap API:
- Bermigrasi ke Nearby Search (Baru)
- Bermigrasi ke Penelusuran Teks (Baru)
- Bermigrasi ke Place Details (Baru)
- Bermigrasi ke Foto Tempat (Baru)
- Bermigrasi ke Autocomplete (Baru)