Ringkasan Address Validation API

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/bujur yang paling dikenal untuk alamat tersebut. Secara opsional, untuk alamat di Amerika Serikat dan Puerto Riko, Anda dapat mengaktifkan Coding Accuracy Support System (CASS™).

Alasan menggunakan Address Validation API

Dengan Address Validation API, Anda dapat meningkatkan prediktabilitas pengiriman dan mengurangi kegagalan pengiriman, sehingga memberikan pengalaman pelanggan yang lebih baik. Anda melakukannya dengan menangkap alamat yang buruk dan mendapatkan kesadaran yang lebih baik tentang karakteristik alamat.

Geocoding API mungkin lebih cocok untuk kebutuhan Anda jika Anda tidak perlu memvalidasi setiap komponen alamat. Geocoding API mengonversi alamat menjadi koordinat lintang dan bujur. Address Validation API memvalidasi alamat untuk kebenaran. Lihat Mem-build kemampuan validasi lokasi menggunakan Google Maps Platform di Architecture Center untuk mengetahui perbandingan mendetail.

Yang dapat Anda lakukan dengan Address Validation API

Coba demo

Dengan Address Validation API, Anda dapat menentukan apakah alamat mengacu pada tempat yang sebenarnya. Jika alamat tidak merujuk ke tempat yang sebenarnya, API dapat mengidentifikasi komponen yang mungkin salah yang dapat Anda tampilkan kepada pelanggan untuk diperbaiki. Berikut adalah contoh alur kerja yang menggunakan API:

  1. Pelanggan memasukkan alamat – Gambar berikut menunjukkan formulir dasar yang memungkinkan pelanggan memasukkan alamat, mungkin sebagai bagian dari alur checkout.

  2. Aplikasi mengirim alamat ke API – Aplikasi meneruskan alamat ini sebagai input ke Address Validation API.

    Alamat yang dimasukkan oleh pelanggan.

  3. API memvalidasi dan menstandarkan alamat – Dalam responsnya, Address Validation API menampilkan alamat lengkap seperti yang ditentukan oleh API, atau menunjukkan bagian yang tidak memiliki informasi.

  4. Pelanggan mengonfirmasi atau mengoreksi alamat – Bergantung pada hal yang ditampilkan API, Anda dapat memberikan perintah berikut kepada pelanggan: A. Konfirmasi alamat yang direkomendasikan. B. Berikan informasi yang belum lengkap. C. Perbaiki alamat.

    Minta pelanggan untuk mengonfirmasi alamat seperti yang ditentukan oleh API.Minta pelanggan untuk memasukkan informasi alamat yang belum lengkap. Minta pelanggan untuk memperbaiki informasi alamat.

Cara kerja Address Validation API

Validasi alamat menerima permintaan POST dengan alamat dalam bentuk isi JSON. Fungsi ini memisahkan alamat menjadi komponen-komponennya, lalu mencoba hal berikut:

  • Corrects—Memberikan pemeriksaan validasi tingkat komponen, termasuk sub-premis jika tersedia.
  • Completes—Mencoba menyimpulkan komponen alamat yang tidak ada atau salah.
  • Format—Membersihkan dan menstandarkan format untuk komponen alamat.

Resource

Tabel berikut merangkum resource yang tersedia melalui Address Validation API beserta data yang ditampilkannya. Untuk mengetahui detail spesifik, lihat referensi Address Validation API.

Referensi data Data yang ditampilkan

Komponen alamat dalam format JSON.

Lihat Memvalidasi alamat.

Alamat lengkap yang divalidasi (jika memungkinkan).

Status validasi setiap komponen alamat.

Jika tersedia untuk alamat:

  • Geocode
  • Presisi alamat
  • Data layanan pos, jika tersedia.

Lihat Memahami respons validasi.

Cara menggunakan Address Validation API

1 Coba demo Pelajari demo dengan berbagai bentuk alamat, baik yang benar maupun yang salah. Demo ini memberikan cara yang berguna untuk menjelajahi nilai yang ditampilkan dari layanan, serta respons API berformat JSON.
2 Memeriksa cakupan Tinjau detail cakupan untuk melihat negara dan wilayah yang didukung Address Validation API.
3 Memulai penyiapan Mulai dengan Menyiapkan project Google Cloud dan selesaikan petunjuk yang mengikutinya.
4 Meminta validasi alamat Mulai dengan alamat dasar, lalu, untuk akurasi tambahan, Anda dapat mengaktifkan CASS (khusus alamat AS dan PR). Lihat Meminta validasi alamat.
5 Memproses respons Respons Address Validation API menyediakan dua properti, yang masing-masing Anda gunakan dengan cara yang berbeda. Lihat Memahami respons dasar.
6 Meningkatkan akurasi validasi Anda dapat membantu meningkatkan akurasi alamat dengan memberikan masukan tentang respons Address Validation API. Lihat Menangani alamat yang diperbarui.

Library klien yang tersedia

Untuk mengetahui daftar library klien yang tersedia untuk Address Validation API, lihat Library klien.

Tentang CASS™

United States Postal Service® (USPS®)1 mengelola Coding Accuracy Support System (CASS™) untuk mendukung dan memberikan sertifikasi kepada penyedia validasi alamat. Layanan CASS Certified™, seperti Address Validation API, telah dikonfirmasi kemampuannya untuk mengisi informasi yang tidak ada di alamat, menstandarkannya, dan memperbaruinya untuk memberi Anda alamat terbaru dan paling akurat.

CASS tidak diaktifkan secara default dan hanya didukung untuk wilayah "US" dan "PR". Untuk mengaktifkan CASS, tetapkan enableUspsCass ke true sebagai bagian dari permintaan validasi. Untuk informasi selengkapnya, lihat Memvalidasi alamat.

Sebagai bagian dari penggunaan layanan USPS, USPS mengevaluasi permintaan untuk alamat yang dibuat secara artifisial. Jika USPS mengidentifikasi alamat input sebagai alamat yang dibuat secara artifisial, Google diwajibkan untuk berhenti memvalidasi alamat bagi pelanggan dan harus melaporkan informasi kontak pelanggan (nama dan alamat), alamat input yang relevan, dan data penggunaan gabungan ke USPS. Dengan menggunakan API, Anda menyetujui Persyaratan Khusus Layanan ini.

Langkah berikutnya

  1. Google Maps Platform adalah Pemegang Lisensi non-eksklusif dari United States Postal Service®. Merek dagang berikut dimiliki oleh United States Postal Service® dan digunakan dengan izin: United States Postal Service®, CASS™, CASS Certified™. ↩