Menambahkan sub-lahan ke alamat - contoh (khusus AS)

Dokumen ini menjelaskan sejumlah skenario dunia nyata saat Address Validation API memberikan sinyal respons yang memerlukan perilaku tambahkan sub-lokasi dari sistem Anda. Sinyal ini hanya tersedia untuk alamat di Amerika Serikat. Lihat Contoh alur kerja di Membangun logika validasi Anda untuk mendapatkan konteks.

Contoh umum: menambahkan sub-lokasi

Skenario ini menggambarkan alamat yang mungkin meminta pelanggan untuk menambahkan nomor unit ke alamat.

Alamat dimasukkan Wilayah
1450 Brickell Avenue, Miami, FL 33131-4065 US

Putusan untuk alamat yang tidak memiliki sub-lokasi

Contoh di bawah ini menyoroti sinyal penting.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Contoh kasus ekstrem: menambahkan sub-lokasi

Contoh berikut mencakup situasi saat verdict menunjukkan masalah kualitas alamat yang memerlukan penyelidikan lebih lanjut. Contoh ini juga mengilustrasikan cara logika Anda dapat berpindah dari putusan ke komponen alamat untuk mendapatkan gambaran yang lebih lengkap guna meningkatkan logika sistem Anda.

Sub-ruang yang tidak ada serta komponen yang disimpulkan dan diganti

Contoh ini menggambarkan entri alamat AS dengan lokalitas yang tidak ada dan kode pos yang salah.

Alamat dimasukkan Wilayah
1450 Brickell Avenue, FL 33132-4065 US

Putusan untuk sub-lokasi yang tidak ada serta komponen yang disimpulkan dan diganti

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "hasReplacedComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Penyelidikan lebih lanjut terhadap komponen alamat mengungkapkan bahwa lokalitas telah disimpulkan, dan kode pos telah diganti.

{
   "componentName": {
     "text": "33131",
   }
   "componentType": "postal_code",
   "confirmationLevel": "CONFIRMED",
   "replaced": true
},
{
   "componentName": {
     "text": "Miami",
     "languageCode": "en"
   }
   "componentType": "locality",
   "confirmationLevel": "CONFIRMED",
   "inferred": true
}