Pelengkapan otomatis (Baru) dan harga sesi

Pilih platform: Android iOS JavaScript Layanan Web

Google merekomendasikan agar Anda menggunakan sesi dengan Autocomplete (Baru). Sesi membantu menyederhanakan harga dan memberikan model penetapan 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 telah habis masa berlakunya akan ditagih seolah-olah tidak ada token sesi.

Sesi yang tidak selesai, yang berarti sesi yang tidak dihentikan oleh permintaan ke Place Details (Baru) atau Validasi Alamat, hanya ditagih untuk permintaan pelengkapan otomatis menggunakan SKU: Permintaan Pelengkapan Otomatis.

Tiga skenario 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 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 menyertakan hal-hal berikut mengenai tempat:

  • 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: Permintaan Autocomplete.
    • Ditagih $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

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 di SKU: Penggunaan Sesi Autocomplete, sehingga permintaan tersebut tidak dikenai biaya.
  • Satu permintaan SKU: Place Details (Preferred):
    • Ditagih $25,00 per 1.000 permintaan hingga 100.000 permintaan
    • Dikenai biaya 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. Google Play juga menstandarkan alamat untuk pengiriman surat dan menemukan koordinat lintang dan bujur yang paling terkenal.

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:

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) 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) 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
  • 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.