Pelengkapan otomatis (Baru) dan harga sesi

Pilih platform: Android iOS JavaScript Layanan Web

Google merekomendasikan agar Anda menggunakan sesi dengan Pelengkapan Otomatis (Baru). Sesi membantu menyederhanakan penetapan harga dan memberikan model penetapan harga yang konsisten untuk digunakan dengan Pelengkapan Otomatis (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 telah habis masa berlakunya 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

Catatan: Jika Anda memilih untuk tidak menggunakan sesi dengan Autocomplete (Baru), Anda akan ditagih per permintaan ke Autocomplete menggunakan SKU: Autocomplete Requests.

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 sugesti 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 (Location Only).

Kemudian, Anda akan ditagih sebagai berikut:

• Setiap permintaan Autocomplete (Baru), hingga maksimum 12 permintaan, menggunakan SKU: Autocomplete Requests.
• Dikenai biaya $2,83 per 1.000 permintaan hingga 100.000 permintaan
• Dikenai biaya $2,27 per 1.000 permintaan hingga 500.000 permintaan
• Permintaan Autocomplete (Baru) 13 dan yang lebih tinggi saat Anda berada dalam sesi aktif akan ditagih dengan SKU: Autocomplete Session Usage, yang berarti tidak ada biaya untuk permintaan tersebut.
• Satu permintaan Places Details menggunakan SKU: Place Details (Location Only):
• Ditagih sebesar $5,00 per 1.000 permintaan hingga 100.000 permintaan
• Dikenai biaya $4,00 per 1.000 permintaan hingga 500.000 permintaan
Catatan: Jika Anda membuat permintaan Place Details menggunakan SKU: Place Details (Location Only), lalu membuat permintaan Address Validation sebelum token sesi berakhir (dalam urutan tersebut), permintaan yang menggunakan SKU: Place Details (Location Only) tidak akan dikenai biaya. Permintaan Address Validation ditagih menggunakan SKU: Address Validation Preferred.

Catatan: Jika Anda menghentikan sesi dengan membuat permintaan ke Place Details (New) menggunakan SKU: Place Details (IDs Only), maka semua permintaan ke Autocomplete (New) akan ditagih menggunakan SKU: Autocomplete Requests, seolah-olah Anda tidak menggunakan sesi. Hal ini karena permintaan yang menggunakan SKU: Place Details (IDs Only) tidak dikenai biaya, sehingga semua permintaan Autocomplete (Baru) akan kembali ke harga per permintaan.

Pelengkapan otomatis untuk penemuan tempat

Dalam skenario Autocomplete 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) Basic, Advanced, atau Preferred.

Kemudian, Anda akan ditagih sebagai berikut:

• Semua permintaan Autocomplete (Baru) ditagih dengan SKU: Penggunaan Sesi Autocomplete, yang berarti tidak ada biaya untuk permintaan tersebut.
• Satu permintaan SKU: Place Details (Preferred):
• Ditagih sebesar $25,00 per 1.000 permintaan hingga 100.000 permintaan
• Ditagih sebesar $20,00 per 1.000 permintaan hingga 500.000 permintaan

Pelengkapan otomatis untuk checkout dan pengiriman

Address Validation API adalah layanan yang menerima alamat. Fungsi 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 Pelengkapan Otomatis 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 dengan SKU: Penggunaan Sesi Autocomplete, yang berarti tidak ada biaya untuk permintaan tersebut.
• Satu permintaan SKU: Address Validation Preferred:
• Ditagih sebesar $25,00 per 1.000 permintaan hingga 100.000 permintaan
• Ditagih sebesar $20,00 per 1.000 permintaan hingga 500.000 permintaan

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	Harga per 1.000 permintaan
Data lokasi	5 permintaan ke Autocomplete (Baru) 1 permintaan ke Place Details (Baru) menggunakan SKU: Place Details (Location Only)	SKU: Autocomplete Requests SKU: Place Details (Location Only)	5 permintaan ke Autocomplete (Baru) yang ditagih sebesar $2,83 (maksimum 12 permintaan untuk sesi) 1 permintaan ke Place Details (Baru) dikenai biaya $5
Penemuan tempat	5 permintaan ke Autocomplete (Baru) 1 permintaan ke Place Details (Baru) menggunakan: SKU: Place Details (Basic) SKU: Place Details (Advanced) SKU: Place Details (Preferred)	SKU: Autocomplete Session Usage SKU: Place Details (Preferred)	5 permintaan ke Autocomplete (Baru) dikenai biaya $0 1 permintaan ke Place Details (Baru) dikenai biaya sebesar $25
Checkout dan pengiriman	5 permintaan ke Autocomplete (Baru) 1 permintaan ke Address Validation	SKU: Autocomplete Session Usage SKU: Address Validation Preferred	5 permintaan ke Autocomplete (Baru) yang ditagih sebesar $0 1 permintaan ke Validasi Alamat Pilihan ditagih sebesar $25

Contoh harga tanpa sesi

Jika tidak menggunakan sesi, Anda akan ditagih per permintaan ke Autocomplete (Baru) menggunakan SKU: Permintaan Autocomplete sebesar $2,83 per 1.000 permintaan.

Harga penggantian untuk sesi yang tidak selesai atau ditinggalkan

Jika sesi ditinggalkan, yang berarti tidak dihentikan oleh panggilan ke Place Details (Baru) atau Address Validation, permintaan Autocomplete (Baru) akan kembali ke model harga per permintaan dan ditagih sebesar 2,83 USD per 1.000 permintaan seperti yang ditentukan oleh SKU: Autocomplete Requests.