Berikan masukan validasi alamat

Untuk membantu kami meningkatkan kualitas Address Validation API, Anda dapat memberikan masukan ke Google untuk memberi tahu kami jika alamat yang divalidasi diterima oleh pengguna akhir. Masukan ini membantu kami meningkatkan akurasi API secara keseluruhan.

Permintaan masukan validasi alamat

Untuk memberikan masukan setelah panggilan ke metode validasi alamat, lakukan panggilan ke metode ProvideValidationMasukan (REST) atau MenyediakanValidationMasukan (gRPC). Contoh berikut membuat permintaan POST ke REST API:

https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=YOUR_API_KEY

Teruskan isi JSON ke permintaan POST yang menentukan kesimpulan validasi alamat:

{
  "conclusion": "VALIDATED_VERSION_USED",
  "responseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}

Dalam hal ini:

  • Kolom conclusion harus mencerminkan hasil validasi yang sebenarnya.

    Dalam contoh ini, Anda meneruskan VALIDATED_VERSION_USED sebagai nilai kolom conclusion untuk menunjukkan bahwa alamat yang Anda gunakan adalah alamat yang ditampilkan oleh API.

    Jika nantinya Anda menggunakan alamat yang diberikan oleh pengguna akhir, teruskan USER_VERSION_USED.

    Untuk mengetahui semua kemungkinan nilai conclusion, lihat ValidationConclusion.

  • Kolom responseId menentukan hasil validasi alamat yang Anda berikan masukan. Nilai ini harus sama dengan nilai responseId yang ditampilkan oleh panggilan sebelumnya ke metode validateAddress.

    Untuk contoh cara memanggil metode validateAddress, lihat Memvalidasi alamat.

Cara menetapkan responseID

Setiap panggilan Address Validation API akan menampilkan nilai unik di kolom responseId pada respons.

Dalam beberapa kasus, Anda dapat melakukan beberapa panggilan ke Address Validation API untuk satu alamat. Misalnya, pengguna akhir mungkin membuat perubahan pada alamat mereka setelah melihat hasil validasi pertama. Kemudian, Anda dapat melakukan validasi kedua di alamat yang diperbarui.

Jika alamat yang Anda coba validasi perlu divalidasi ulang, teruskan responseId dari respons pertama di kolom previousResponseId pada semua permintaan tindak lanjut ke Address Validation API.

Setiap respons terhadap permintaan tindak lanjut ini berisi responseId baru, tetapi terus gunakan nilai dari responseId pertama di previousResponseId hingga validasi selesai.

Untuk mengetahui informasi selengkapnya tentang cara memvalidasi alamat yang diperbarui, lihat Memvalidasi alamat yang diperbarui.

Di akhir serangkaian validasi, sebaiknya Anda melakukan panggilan ke API Memberikan Validasi untuk memberi tahu kami hasil akhir semua validasi. Teruskan responseId dari respons pertama dalam permintaan Memberikan Masukan Masukan API.

Diagram urutan ini menunjukkan alur yang diinginkan:

Gunakan ID respons untuk memvalidasi alamat.