Token Sesi

Pilih platform: Android iOS JavaScript Web Service

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 dan panggilan ke Place Details dilakukan. Setiap sesi dapat memiliki beberapa kueri pelengkapan otomatis, yang diikuti dengan satu pilihan tempat. Kunci API yang digunakan untuk setiap permintaan dalam sebuah sesi harus milik 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).

Sebaiknya ikuti 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 berasal dari project Konsol Google Cloud yang sama.
  • Pastikan untuk meneruskan token sesi yang unik untuk setiap sesi baru. Penggunaan token yang sama untuk lebih dari satu sesi akan mengakibatkan setiap permintaan ditagih satu per satu.

Anda dapat memilih untuk menghilangkan 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 akan dipanggil setiap beberapa penekanan tombol (bukan per karakter), dan daftar kemungkinan hasil akan ditampilkan. Saat pengguna membuat pilihan dari daftar hasil, pilihan tersebut akan dihitung sebagai permintaan, dan semua permintaan yang dibuat selama penelusuran akan digabungkan dan dihitung sebagai satu permintaan. Jika pengguna memilih tempat, kueri penelusuran tersedia gratis, dan hanya permintaan data Tempat yang dikenai biaya. Jika pengguna tidak menentukan pilihan dalam beberapa menit di 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 akan membuat token sesi baru, "Token A".
  3. 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"
  4. Saat pengguna membuat pilihan:
    • Semua permintaan yang dihasilkan dari kueri 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 direpresentasikan oleh "Token A".
  5. Sesi berakhir, dan aplikasi akan menghapus "Token A".

Untuk informasi selengkapnya tentang cara penagihan permintaan Autocomplete, lihat Penggunaan dan Penagihan.

Membuat token sesi

Anda dapat membuat token sesi menggunakan mekanisme terprogram mana pun yang Anda inginkan. Sebaiknya gunakan UUID versi 4 untuk token sesi.