Memilih solusi Address Validation

Diagram alur yang menunjukkan ringkasan umum langkah-langkah pengujian.

Tujuan

Validasi Alamat memberikan nilai untuk berbagai kasus penggunaan dan ada pertimbangan utama di luar kualitas mentah hasil pengujian yang sebaiknya Anda pelajari. Misalnya: tampilan holistik produk yang kompatibel dalam alur pengguna seperti Place Autocomplete dan Maps, ketersediaan regional, serta kepercayaan & keandalan tingkat perusahaan.

Setelah Anda sampai pada tahap evaluasi Address Validation API, berikut beberapa panduan yang sebaiknya Anda gunakan sebagai bagian dari pengujian.

Tujuan pengujian ini adalah:

  1. Pastikan Address Validation API sesuai untuk kasus penggunaan Anda.
  2. Verifikasi cara Address Validation API memenuhi persyaratan solusi Anda, seperti:
    • Mengidentifikasi alamat berkualitas baik.
    • Memberikan peringatan untuk mengatasi input alamat yang berkualitas buruk.
    • Membuat koreksi pada data alamat, termasuk inferensi, penggantian, dan koreksi ejaan.
    • Memberikan alamat berformat untuk pengiriman.
    • Memberikan peringatan jika data sublokasi tidak ada atau salah (khusus Amerika Serikat).
  3. Pastikan Anda akan menerima manfaat terukur dari penerapan API.

Setelah melakukan pengujian, Anda akan dapat menjawab pertanyaan di atas, dan menentukan apakah API cocok untuk bisnis Anda.

Menyiapkan data

Pengujian harus dilakukan terhadap sampel data alamat yang ada. Jangan memilih data secara manual untuk pengujian, tetapi pilih sampel acak yang mewakili wilayah geografis tempat Anda beroperasi. Artinya, jika Anda beroperasi di Amerika Serikat dan Inggris Raya, tetapi 70% bisnis Anda dilakukan di Inggris Raya dan 30% di Amerika Serikat, sampel harus mencerminkan pembagian tersebut.

Gunakan alamat dari titik pengambilan gambar. Misalnya, jika Anda berencana menerapkan validasi alamat dalam checkout e-commerce, gunakan alamat yang dimasukkan oleh pelanggan di formulir, sebelum pemrosesan yang ada terjadi yang mungkin digantikan dengan menerapkan Address Validation API.

Siapkan ukuran sampel sekitar 5.000 - 10.000 data untuk pengujian.

Memanggil API

Prasyarat bagian: Pahami cara mengirim permintaan validasi alamat.

Setelah menyiapkan data, Anda harus menjalankan setiap data alamat terhadap API.

Lihat dokumentasi Address Validation API untuk panduan tentang cara memanggil API. Kami juga memiliki artikel yang menjelaskan praktik terbaik untuk menggunakan Address Validation API untuk memproses alamat dalam volume tinggi.

Hasil dari langkah ini adalah keluaran data dari API untuk setiap rekaman alamat. Kemudian, Anda dapat menganalisis hasilnya untuk menentukan kesesuaian API untuk kasus penggunaan Anda. Apakah itu menggunakan spreadsheet, database, atau alat lainnya, terserah Anda.

Meninjau hasil

Prasyarat bagian: Pahami cara menangani respons validasi, terutama konsep Perbaiki, Konfirmasi, dan Terima.

Di bagian ini kami akan membahas skenario keluaran yang dapat Anda analisis untuk menilai kesesuaian solusi.

Ringkasan kolom API utama yang dibahas dalam dokumen ini

Data Respons

Apa itu?

Cara Mengevaluasi

Apa Manfaatnya?

verdict.inputGranularity

Menjelaskan tingkat ketelitian input alamat.

SUB_PREMISE

PREMISE

PREMISE_PROXIMITY

BLOKIR

ROUTE

LAINNYA

Memungkinkan Anda menentukan apakah alamat masukan memiliki cukup data untuk berpotensi valid.

verdict.validationGranularity

Menjelaskan validasi keluaran keseluruhan dari alamat tersebut.

SUB_PREMISE

PREMISE

PREMISE_PROXIMITY

BLOKIR

ROUTE

LAINNYA

Memungkinkan Anda menentukan kualitas alamat keseluruhan pada keluaran dari API.

verdict.hasInferredComponents

Memberi sinyal jika API telah menyimpulkan suatu komponen.

Benar/Salah

API dapat menambahkan komponen yang hilang jika dapat menyimpulkan data. Misalnya, kode Negara Bagian tidak ada.

verdict.hasReplacedComponents

Memberi sinyal jika API telah mengganti suatu komponen.

Benar/Salah

API dapat mengganti komponen yang salah dengan data yang benar dalam beberapa skenario.

verdict.addressComplete

Memberi sinyal jika alamat sudah lengkap.

Benar/Salah

Jika API menentukan bahwa alamat output memiliki semua komponen yang diperlukan, nilai ini akan benar (true).

address.missingComponentTypes

Sinyal untuk memperingatkan jika alamat tersebut kehilangan komponen.

Melihat tabel dua untuk nilai-nilai.

Sorot komponen yang hilang dari alamat yang tidak lengkap.

Tinjau alamat yang valid

Urutkan data yang dikembalikan dari API untuk menentukan kumpulan alamat yang diterima sistem Anda sebagai alamat yang valid. Sinyal utama yang harus dicari dari API adalah:

  • verdict.validationGranularity berisi PREMISE atau lebih baik.
  • verdict.addressComplete adalah true.
  • Tidak ada komponen yang disimpulkan atau diganti.

Lihat menerima alamat untuk informasi selengkapnya.

Output latihan ini harus berupa subset data alamat yang akan diterima sebagai valid oleh sistem Anda. Pada titik ini, Anda dapat menentukan:

  • Apakah tingkat persentase penerimaan dapat diterima?
  • Jika Anda menggunakan alur kerja validasi alamat yang ada, apakah rasio penerimaannya setara atau lebih baik?

Contoh: Alamat yang valid

Alamat dimasukkan

Wilayah

76 Buckingham Palace Road, London SW1W 9TQ

Inggris Raya

Putusan:

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

Meninjau alamat yang tidak valid

Langkah ini adalah kesempatan untuk meninjau secara manual beberapa data alamat yang telah ditandai sebagai tidak valid, dan melihat apakah, tanpa menggunakan Address Validation API, alamat yang tidak valid tersebut dapat menyebabkan masalah di hilir.

Urutkan data yang ditampilkan dari API untuk menentukan kumpulan alamat yang akan ditandai sebagai tidak valid oleh sistem Anda. Sinyal utama yang harus dicari dari API adalah:

  • verdict.validationGranularity ditetapkan ke OTHER atau ROUTE, bergantung pada tingkat risiko Anda.
  • verdict.addressComplete adalah false.

Lihat memperbaiki alamat untuk mengetahui informasi selengkapnya.

Output latihan ini harus berupa subset data alamat yang akan ditandai sebagai tidak valid oleh sistem Anda. Pada tahap ini, Anda dapat menentukan apakah persentase tarif yang tidak valid dapat diterima.

Penting untuk diperhatikan bahwa menandai alamat sebagai tidak valid adalah bagian inti dari fungsi Address Validation API, dan tingkat alamat yang ditandai sebagai tidak valid yang tinggi tidak selalu mencerminkan kualitas API yang buruk. API memberi Anda informasi bahwa ada yang salah dengan alamat tersebut, dan hal ini dapat meningkatkan efisiensi alur kerja Anda dengan mendeteksi error lebih awal, sebelum menyebabkan masalah di hilir.

Contoh: Alamat tidak valid

Alamat dimasukkan

Wilayah

21 45 40th street

AS

Putusan:

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Meninjau komponen yang tidak ada atau belum dikonfirmasi

Pada tahap ini, komponen yang hilang atau belum dikonfirmasi juga dapat ditinjau. Ini adalah bagian dari objek Address dalam respons. Dua kolom tersebut adalah missingComponentTypes dan unconfirmedComponentTypes.

Gunakan kolom ini untuk membantu mendeteksi alasan alamat ditandai sebagai tidak valid oleh API, dan kumpulkan informasi yang benar untuk alamat yang akan membuatnya valid, dengan memberikan masukan ke titik pengumpulan data kolom tertentu yang salah. Dengan cara ini, API memberikan nilai dengan memberi Anda informasi spesifik tentang kualitas data Anda.

Contoh: Komponen tidak ada & belum dikonfirmasi

Alamat dimasukkan

Wilayah

Fake St, New York, NY 10011

AS

Putusan:

{
     "inputGranularity": "ROUTE",
     "validationGranularity": "OTHER",
     "geocodeGranularity": "OTHER",
     "hasUnconfirmedComponents": true
}

Komponen tidak ada & tidak dikonfirmasi

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

Meninjau alamat dengan koreksi

Address Validation API dapat melakukan koreksi pada data input, dengan mengambil input alamat yang berpotensi tidak valid dan menghasilkan data alamat yang valid. Ini adalah salah satu cara API memberikan nilai tambah, dan penting untuk mencatatnya sebagai bagian dari pengujian.

Sinyal utama yang harus diperhatikan adalah:

  • inferred, replaced, atau spellCorrected disetel ke true di salah satu addressComponents.
  • verdict.hasInferredComponents, atau verdict.hasReplacedComponents disetel ke true.

Lihat mengonfirmasi alamat untuk mengetahui informasi selengkapnya.

Output latihan ini harus berupa subset data alamat yang telah diterapkan koreksi oleh API.

Sebagian data ini dapat ditinjau secara manual untuk menentukan apakah API melakukan koreksi pada data Anda yang akan mengurangi hambatan dalam alur kerja hilir Anda.

Contoh: Alamat dengan koreksi

Alamat dimasukkan

Wilayah

76 Bruckingm Palace Road, London SW1W 9TQ

Inggris Raya

Rute addressComponent

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[Khusus Amerika Serikat] Meninjau alamat dengan data sub-tempat yang tidak ada atau salah

Address Validation API dapat menentukan apakah sub-lokasi tidak ada atau salah, untuk alamat AS.

Sinyal utama yang harus diperhatikan adalah:

  • Dalam objek Address:
    • unconfirmedComponentTypes berisi subpremise
    • missingComponentTypes berisi subpremise
  • Dalam objek UspsData:
    • dpvConfirmation adalah D (sub-tempat tidak ada)
    • dpvConfirmation adalah S (sub-tempat belum dikonfirmasi)

Lihat menangani alamat Amerika Serikat untuk mengetahui informasi selengkapnya.

Pengujian ini akan menunjukkan apakah ada masalah dalam data Anda dengan sub-lokasi yang tidak ada atau salah, seperti nomor apartemen. Hal ini dapat menyebabkan masalah hilir, terutama untuk kasus penggunaan penayangan. Address Validation API dapat menambah nilai pada alur kerja Anda dengan mengidentifikasi hal ini lebih awal, sehingga Anda dapat menerapkan langkah-langkah untuk mengumpulkan data yang telah dikoreksi.

Contoh: Sub-lokasi tidak ada

Alamat dimasukkan

Wilayah

111 8th Avenue, Manhattan, NY 10011

US

Komponen tidak ada

"missingComponentTypes": [
    "subpremise"
]

Konfirmasi DPV data USPS

"dpvConfirmation": "D"

[Khusus Amerika Serikat] Meninjau standardizedAddress USPS

Address Validation API juga menampilkan alamat standar USPS untuk alamat di Amerika Serikat. Hal ini sangat penting jika Anda memerlukan alamat berformat USPS untuk dicetak pada label pengiriman.

UspsAddress dapat ditinjau untuk melihat data ini, dan menentukan apakah data tersebut menambah nilai pada alur kerja Anda.

Contoh: Alamat standar USPS

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

Kesimpulan

Mulai pengujian - mulai pengujian Address Validation API Anda hari ini untuk memastikan data alamat yang akurat, meningkatkan pengalaman pelanggan, dan menyederhanakan operasi bisnis Anda. Setelah mengikuti skenario pengujian yang diuraikan di atas, Anda akan memiliki informasi yang diperlukan untuk menentukan apakah Address Validation API akan memberikan nilai pada alur kerja Anda.

Bacaan lebih lanjut yang disarankan:

Kontributor

Henrik Valve | DevX Engineer