Google merekomendasikan agar Anda menggunakan sesi dengan Autocomplete (Baru). Sesi membantu menyederhanakan harga dan memberikan model harga yang konsisten untuk digunakan dengan Autocomplete (Baru).
Harga per sesi dimulai dengan permintaan Autocomplete (Baru) pertama yang menyertakan token sesi, berlanjut melalui setiap permintaan Autocomplete (Baru) berikutnya, dan kemudian dihentikan oleh permintaan ke Place Details (Baru) atau Validasi Alamat yang menggunakan token sesi.
Setelah sesi berakhir, setiap panggilan ke Autocomplete (Baru), Place Details (Baru), atau Validasi Alamat yang menggunakan token sesi yang sudah tidak berlaku akan ditagih seolah-olah tidak ada token sesi.
Sesi yang tidak lengkap, yang berarti sesi yang tidak dihentikan oleh permintaan ke Place Details (Baru) atau Validasi Alamat, hanya ditagih untuk permintaan pelengkapan otomatis menggunakan SKU: Autocomplete Requests.
Tiga skenario penetapan harga yang paling umum adalah:
- Pelengkapan otomatis untuk data lokasi
- Pelengkapan otomatis untuk penemuan tempat
- Pelengkapan otomatis untuk checkout dan pengiriman
Pelengkapan otomatis untuk data lokasi
Dalam skenario ini, Anda tertarik menggunakan Autocomplete dan Place Details (Baru) untuk mendapatkan informasi lokasi tentang suatu tempat. Misalnya, Anda memilih saran dari pelengkapan otomatis, lalu menggunakan Place Details (Baru) untuk mendapatkan koordinat lintang dan bujur tempat tersebut guna menampilkan tempat tersebut di peta.
Informasi lokasi dapat mencakup:
- Alamat
- Lokasi sebagai koordinat lintang dan bujur
- Plus Codes
- Jenis
- Area Pandang
Sesi ini dihentikan oleh satu permintaan ke Place Details (Baru) yang meminta kolom apa pun yang ditentukan oleh SKU: Place Details Essentials.
Sesi dimulai dengan permintaan Autocomplete (Baru) pertama yang menyertakan token sesi, berlanjut melalui setiap permintaan Autocomplete (Baru) berikutnya, lalu dihentikan oleh permintaan ke Place Details (Baru) atau Validasi Alamat yang menggunakan token sesi. Untuk sesi Autocomplete (Baru), berikut cara penagihan Anda:
- 12 permintaan Autocomplete (Baru) pertama: Anda akan ditagih untuk setiap permintaan Autocomplete (Baru), hingga maksimum 12 permintaan, menggunakan SKU: Permintaan Autocomplete.
- Untuk permintaan Autocomplete (Baru) ke-13 dan yang lebih tinggi dalam sesi yang sama: Anda ditagih berdasarkan SKU: Autocomplete Session Usage, yang berarti tidak ada biaya untuk permintaan tersebut.
- Permintaan Place Details atau Validasi Alamat: Anda juga akan ditagih untuk permintaan akhir menggunakan SKU tersebut.
Pelengkapan otomatis untuk penemuan tempat
Dalam skenario Pelengkapan Otomatis untuk penemuan tempat, Anda tertarik untuk mendapatkan lebih dari sekadar data lokasi tentang suatu tempat. Misalnya, Anda dapat meminta salah satu hal berikut:
- Opsi aksesibilitas
- Jam buka saat ini
- Opsi tempat parkir
- Ulasan
- Rating
Untuk skenario ini, sesi Anda dihentikan oleh permintaan ke Place Details (Baru) yang meminta kolom apa pun yang disertakan dalam Place Details (Baru) SKU Pro, Enterprise, atau Enterprise + Atmosphere.
Kemudian, Anda akan ditagih sebagai berikut:
- Semua permintaan Autocomplete (Baru) ditagih berdasarkan SKU: Penggunaan Sesi Autocomplete, yang berarti tidak ada biaya untuk permintaan tersebut.
Pelengkapan otomatis untuk checkout dan pengiriman
Address Validation API adalah layanan yang menerima alamat. API ini mengidentifikasi komponen alamat dan memvalidasinya. API ini juga menyeragamkan alamat untuk pengiriman surat dan menemukan koordinat lintang dan bujur terbaik yang diketahui untuk alamat tersebut.
Dalam skenario Pelengkapan Otomatis untuk checkout dan pengiriman, Anda mengakhiri sesi dengan permintaan ke Address Validation API untuk memvalidasi alamat yang dipilih. Kemudian, Anda akan ditagih sebagai berikut:
- Semua permintaan Autocomplete (Baru) ditagih berdasarkan SKU: Penggunaan Sesi Autocomplete, yang berarti tidak ada biaya untuk permintaan tersebut.
- Permintaan SKU: Place Details Essentials opsional.
- One SKU: Address Validation Enterprise request.
Contoh penghitungan harga
Tabel berikut menampilkan contoh harga untuk tiga skenario sesi utama. Tabel ini juga mencantumkan SKU yang muncul di laporan penagihan Anda untuk setiap skenario.
Skenario | Contoh permintaan | SKU yang ditagih | Permintaan ditagih |
---|---|---|---|
Data lokasi |
|
|
|
Penemuan tempat |
|
|
|
Checkout dan pengiriman |
|
|
Contoh harga tanpa sesi
Jika tidak menggunakan sesi, Anda akan ditagih per permintaan ke Autocomplete (Baru) menggunakan SKU: Permintaan Autocomplete.
Harga pengganti untuk sesi yang tidak lengkap atau ditinggalkan
Jika sesi dihentikan, yang berarti tidak diakhiri dengan panggilan ke Place Details (Baru) atau Validasi Alamat, permintaan Autocomplete (Baru) akan kembali ke model harga per permintaan dan ditagih sesuai dengan SKU: Autocomplete Requests.