Google merekomendasikan agar Anda menggunakan sesi dengan Pelengkapan Otomatis (Baru). Sesi membantu menyederhanakan harga dan memberikan model harga yang konsisten untuk digunakan dengan Autocomplete (Baru).
Harga 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 Address Validation yang menggunakan token sesi.
Setelah sesi berakhir, setiap panggilan ke Autocomplete (Baru), Place Details (Baru), atau Address Validation yang menggunakan token sesi yang sudah tidak berlaku akan ditagih seolah-olah tidak ada token sesi.
Sesi yang tidak lengkap, yaitu sesi yang tidak dihentikan oleh permintaan ke Place Details (Baru) atau Address Validation, 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 untuk menggunakan Autocomplete dan Place Details (Baru) untuk mendapatkan informasi lokasi tentang suatu tempat. Misalnya, Anda memilih saran dari pelengkapan otomatis, lalu menggunakan Place Details (New) untuk mendapatkan koordinat lintang dan bujur tempat untuk 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 (New) 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 Address Validation yang menggunakan token sesi. Untuk sesi Pelengkapan Otomatis (Baru), berikut cara penagihan Anda:
- 12 permintaan Autocomplete (Baru) pertama: Anda ditagih untuk setiap permintaan Autocomplete (Baru), hingga maksimum 12 permintaan, menggunakan SKU: Autocomplete Requests.
- Untuk permintaan Autocomplete (Baru) 13 dan yang lebih tinggi dalam sesi yang sama: Anda ditagih dengan SKU: Autocomplete Session Usage, yang berarti tidak ada biaya untuk permintaan tersebut.
- Permintaan Places Details atau Address Validation: Anda juga ditagih untuk permintaan akhir yang 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 (New) yang meminta kolom apa pun yang disertakan dalam SKU Place Details (New) 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. Fungsi ini juga menstandarkan alamat untuk pengiriman dan menemukan koordinat lintang dan bujur yang paling dikenal untuk alamat tersebut.
Dalam skenario Autocomplete untuk checkout dan pengiriman, Anda menghentikan 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.
- Satu permintaan SKU: Address Validation Enterprise:
Contoh penghitungan harga
Tabel berikut menunjukkan contoh harga untuk tiga skenario sesi utama. Tabel ini juga mencantumkan SKU yang muncul di laporan penagihan untuk setiap skenario.
| Skenario | Contoh permintaan | SKU yang ditagih | Permintaan yang 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 penggantian untuk sesi yang tidak selesai atau ditinggalkan
Jika sesi ditinggalkan, yang berarti tidak dihentikan oleh panggilan ke Place Details (Baru) atau Alamat Validasi, permintaan Autocomplete (Baru) akan kembali ke model harga per permintaan dan ditagih sesuai dengan SKU: Permintaan Autocomplete.