Place Autocomplete (Lama) 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 pengguna memilih tempat dan panggilan ke Place Details (Lama) dilakukan. Setiap sesi dapat memiliki beberapa kueri pelengkapan otomatis, yang diikuti dengan satu pilihan tempat. Kunci API yang digunakan untuk setiap permintaan dalam satu 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 (Lama) dan Place Details (Lama) dalam satu 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 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 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 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 memilih apa pun dalam beberapa menit setelah sesi dimulai, hanya kueri penelusuran yang akan dikenai biaya.
Pertimbangkan 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 satu permintaan.
- Pilihan pengguna dihitung sebagai permintaan Place Detail, dan ditambahkan ke sesi yang diwakili oleh "Token A".
- Sesi diakhiri, dan aplikasi menghapus "Token A".
Untuk informasi selengkapnya tentang cara penagihan permintaan Place Autocomplete (Lama), lihat Penggunaan dan Penagihan.
Membuat token sesi
Untuk membuat token sesi, panggil
GMSAutocompleteSessionToken.init().