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 mereka 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 sesi harus berasal dari 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 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 sesi berasal dari project konsol Google Cloud yang sama.
- Pastikan untuk meneruskan token sesi yang unik untuk setiap sesi baru. Jika menggunakan token yang sama untuk lebih dari satu sesi, setiap permintaan akan ditagih satu per satu.
Anda dapat memilih untuk menghapus token sesi pelengkapan otomatis dari permintaan. Jika token sesi dihilangkan, setiap permintaan ditagih secara terpisah, yang memicu SKU Autocomplete - Per Request. Jika Anda menggunakan kembali token sesi, 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 ketukan 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 dipaketkan 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 sejak awal sesi, hanya kueri penelusuran yang akan ditagih.
Mari kita periksa alur peristiwa ini dari perspektif 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, menampilkan daftar baru potensi hasil untuk setiap karakter:
"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 satu permintaan.
- 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 Autocomplete, lihat Penggunaan dan Penagihan.
Membuat token sesi
Untuk membuat token sesi, panggil
AutocompleteSessionToken.newInstance().