Place Autocomplete menggunakan token sesi untuk mengelompokkan fase kueri dan pemilihan
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, diikuti dengan satu pilihan tempat. Kunci API yang digunakan untuk setiap permintaan dalam sesi harus merupakan bagian dari project Google Cloud Console 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 pedoman 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 akan menjadi bagian dari project Google Cloud Console yang sama.
- Pastikan untuk meneruskan token sesi yang unik untuk setiap sesi baru. Jika Anda menggunakan token yang sama untuk lebih dari satu sesi, setiap permintaan akan ditagih satu per satu.
Anda dapat secara opsional menghapus token sesi pelengkapan otomatis dari permintaan. Jika token sesi dihilangkan, setiap permintaan akan ditagih secara terpisah, yang 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 dipaketkan dan dihitung sebagai satu permintaan. Jika pengguna memilih sebuah tempat, kueri penelusuran akan tersedia tanpa biaya, dan hanya permintaan data Tempat yang akan dikenai biaya. Jika pengguna tidak memilih dalam waktu beberapa menit pada awal sesi, hanya kueri penelusuran yang dikenai biaya.
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 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 dikelompokkan dan ditambahkan ke sesi yang diwakili oleh "Token A", sebagai permintaan tunggal.
- Pilihan pengguna dihitung sebagai permintaan Place Details, dan ditambahkan ke sesi yang diwakili oleh "Token A".
- Sesi telah selesai, dan aplikasi akan 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().