Menggunakan token sesi

Token sesi mengelompokkan fase kueri dan pemilihan dari penelusuran pelengkapan otomatis pengguna ke dalam sesi terpisah untuk tujuan penagihan.

Buat token sesi. Pengguna bertanggung jawab untuk menghasilkan token sesi unik untuk setiap sesi. Google merekomendasikan penggunaan UUID versi 4.

Contoh

Saat pengguna mengetik kueri, permintaan pelengkapan otomatis akan dipanggil setiap beberapa penekanan 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 akan digabungkan dan dihitung sebagai satu permintaan. Jika pengguna memilih tempat, kueri penelusuran akan tersedia tanpa biaya, dan hanya permintaan data Tempat yang dikenai biaya. Jika pengguna tidak membuat pilihan dalam beberapa menit pada awal sesi, hanya kueri penelusuran yang akan dikenai biaya.

Mari kita periksa alur peristiwa ini dari perspektif aplikasi.

  1. Pengguna mulai mengetik kueri untuk menelusuri "Paris, Prancis".
  2. Setelah mendeteksi input pengguna, aplikasi membuat token sesi baru, "Token A".
  3. Saat pengguna mengetik, API membuat permintaan pelengkapan otomatis setiap beberapa karakter, yang menampilkan daftar baru hasil potensial untuk setiap:
    "P"
    "Par"
    "Paris,"
    "Paris, Fr"
  4. 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 mengetahui informasi selengkapnya tentang cara penagihan permintaan Autocomplete, lihat Penggunaan dan Penagihan.