Berikan masukan validasi alamat

Untuk membantu kami meningkatkan kualitas Address Validation API, Anda dapat memberikan masukan kepada Google secara opsional untuk memberi tahu kami apakah 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 provideValidationFeedback (REST) atau metode ProvideValidationFeedback (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 akhirnya Anda gunakan adalah alamat yang ditampilkan oleh API.

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

  Untuk mengetahui semua kemungkinan nilai untuk conclusion, lihat ValidationConclusion.

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

  Untuk contoh tentang memanggil metode validateAddress, lihat Memvalidasi alamat.

Cara menetapkan responseID

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

Dalam beberapa kasus, Anda dapat melakukan beberapa panggilan ke Address Validation API untuk satu alamat. Misalnya, pengguna akhir mungkin mengubah alamatnya setelah melihat hasil validasi pertama. Anda kemudian melakukan validasi kedua pada alamat yang diperbarui.

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

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

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

Di akhir rangkaian validasi, sebaiknya lakukan panggilan ke Provide Validation Feedback API untuk memberi tahu kami hasil akhir dari semua validasi. Teruskan responseId dari respons pertama dalam permintaan Provide Validation Feedback API.

Diagram urutan ini menunjukkan alur yang diinginkan: