Token sesi mengelompokkan fase kueri dan pemilihan dari pelengkapan otomatis pengguna menelusuri ke sesi terpisah untuk tujuan penagihan.
Membuat token sesi
Pengguna bertanggung jawab untuk membuat token sesi yang unik untuk setiap sesi. Google merekomendasikan penggunaan UUID versi 4.
Contoh
Saat pengguna mengetik kueri, permintaan pelengkapan otomatis dipanggil setiap beberapa penekanan tombol (bukan per karakter), dan daftar hasil yang mungkin ditampilkan. Kapan pengguna membuat pilihan dari daftar hasil, pilihan tersebut dihitung sebagai 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 membuat pilihan dalam beberapa menit setelah awal sesi, hanya kueri penelusuran akan dikenai biaya.
Mari kita periksa alur peristiwa ini dari perspektif aplikasi.
- Pengguna mulai mengetik kueri untuk menelusuri "Paris, Prancis".
- Setelah mendeteksi input pengguna, aplikasi membuat sesi baru token A, "Token A".
- Saat pengguna mengetik, API membuat permintaan pelengkapan otomatis setiap beberapa
karakter, dengan menampilkan daftar hasil potensial baru untuk masing-masing:
"P"
"Par"
"Paris",
"Paris, Fr"
- Saat pengguna membuat pilihan:
- Semua permintaan yang dihasilkan dari kueri dikelompokkan dan ditambahkan ke sesi yang diwakili 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 menghapus "Token A".
Untuk informasi selengkapnya tentang cara penagihan permintaan Pelengkapan Otomatis, lihat Penggunaan dan Penagihan.