Place Autocomplete menggunakan token sesi untuk mengelompokkan fase kueri dan pemilihan
dari penelusuran pelengkapan otomatis pengguna ke dalam sesi terpisah untuk tujuan
penagihan. Sesi dimulai saat pengguna mulai mengetik kueri, dan berakhir saat memilih tempat, lalu panggilan ke Place Details akan dilakukan. Setiap sesi dapat memiliki beberapa kueri pelengkapan otomatis, yang diikuti dengan satu pilihan tempat. Kunci API yang digunakan untuk setiap permintaan dalam suatu sesi harus termasuk dalam project Konsol Google Cloud yang sama. Setelah sesi selesai, token tidak lagi
valid; aplikasi Anda harus membuat token baru untuk setiap sesi. Jika parameter sessiontoken dihilangkan, atau jika Anda menggunakan kembali token sesi, sesi tersebut akan dikenai biaya seolah-olah tidak ada token sesi yang diberikan (setiap permintaan ditagih secara terpisah).
Kami merekomendasikan panduan berikut:
- Gunakan token sesi untuk semua sesi pelengkapan otomatis.
- Buat token baru untuk setiap sesi.
- Pastikan kunci API yang digunakan untuk semua permintaan Place Autocomplete dan Place Details dalam sebuah sesi merupakan bagian dari project Google Cloud Console yang sama.
- Pastikan untuk meneruskan token sesi yang unik untuk setiap sesi baru. Jika token yang sama digunakan untuk lebih dari satu sesi, setiap permintaan akan ditagih satu per satu.
Anda juga dapat menghapus token sesi pelengkapan otomatis dari permintaan. Jika token sesi dihilangkan, setiap permintaan akan ditagih secara terpisah, sehingga memicu SKU Autocomplete - Per Request. Jika token sesi digunakan ulang, sesi tersebut dianggap tidak valid dan permintaan akan dikenai biaya seolah-olah tidak ada token sesi yang diberikan.
Contoh
Saat pengguna mengetik kueri, permintaan pelengkapan otomatis dipanggil setiap beberapa tombol (bukan per karakter), dan daftar kemungkinan hasil akan ditampilkan. Saat pengguna membuat pilihan dari daftar hasil, pilihan tersebut dihitung sebagai permintaan, dan semua permintaan yang dibuat selama penelusuran digabungkan dan dihitung sebagai satu permintaan. Jika pengguna memilih tempat, kueri penelusuran tersedia tanpa biaya, dan hanya permintaan data Tempat yang dikenai biaya. Jika pengguna tidak memilih dalam beberapa menit sejak awal sesi, hanya kueri penelusuran yang dikenai biaya.
Mari kita periksa alur peristiwa ini dari perspektif sebuah aplikasi.
- Pengguna mulai mengetik kueri untuk menelusuri "Paris, Prancis".
- Setelah mendeteksi input pengguna, aplikasi akan membuat token sesi baru, "Token A".
- Saat pengguna mengetik, API akan membuat permintaan pelengkapan otomatis setiap beberapa
karakter, yang menampilkan daftar baru hasil potensial untuk setiap karakter:
"P"
"Par"
"Paris",
"Paris, Fr"
- Saat pengguna membuat pilihan:
- Semua permintaan yang dihasilkan dari kueri tersebut dikelompokkan dan ditambahkan ke sesi yang direpresentasikan oleh "Token A", sebagai permintaan tunggal.
- Pilihan pengguna dihitung sebagai permintaan Place Detail, dan ditambahkan ke sesi yang diwakili oleh "Token A".
- Sesi selesai, dan aplikasi akan menghapus "Token A".
Untuk mengetahui informasi selengkapnya tentang cara penagihan permintaan Autocomplete, lihat Penggunaan dan Penagihan.
Membuat token sesi
Untuk membuat token sesi, panggil
AutocompleteSessionToken.newInstance().