Menerima alamat - contoh

Dokumen ini menjelaskan sejumlah skenario dunia nyata saat Address Validation API memberikan sinyal respons yang menjamin perilaku accept dari sistem Anda. Lihat Ringkasan alur kerja di Menggunakan respons validasi untuk konteks.

Contoh umum: menerima

Skenario ini menggambarkan alamat yang akan digunakan sistem Anda untuk menerima alamat yang dimasukkan oleh pelanggan.

Alamat dimasukkan Wilayah
76 Buckingham Palace Road, London SW1W 9TQ Inggris Raya

Putusan untuk alamat yang dapat diterima

Contoh di bawah ini menyoroti sinyal yang penting.

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

Selain itu, respons tersebut menunjukkan hal berikut:

  • hasUnconfirmedComponents tetap menjadi false
  • hasInferredComponents tetap menjadi false
  • hasReplacedComponents tetap menjadi false

Jika digabungkan, sinyal ini menunjukkan alamat berkualitas tinggi.

Contoh kasus ekstrem: menerima

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

Nomor jalan non-AS yang belum dikonfirmasi

Contoh ini mengilustrasikan entri alamat di Italia dengan semua komponen alamat yang ada, bersama tanpa komponen yang disimpulkan atau diganti. Namun, validationGranularity adalah ROUTE.

Alamat dimasukkan Wilayah
Melalui Fonte Grugnale, 14 unit 2, 66054 VASTo CH, Italia IT

Putusan untuk nomor jalan yang belum dikonfirmasi

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

Penyelidikan lebih lanjut terhadap komponen alamat mengungkapkan bahwa nomor jalan adalah UNCONFIRMED_BUT_PLAUSIBLE.

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Nomor jalan AS yang belum dikonfirmasi

Contoh ini mengilustrasikan entri alamat AS dengan semua komponen alamat yang ada, tanpa komponen yang disimpulkan atau diganti. Namun, validationGranularity adalah PREMISE_PROXIMITY.

Alamat dimasukkan Wilayah
975 Carson Dr, Sunnyvale, CA 94086 Amerika Serikat

Data USPS untuk nomor jalan yang belum dikonfirmasi

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

Data USPS tidak lengkap untuk alamat yang dikonfirmasi

Contoh ini mengilustrasikan entri alamat AS dengan semua komponen alamat yang dikonfirmasi, tanpa komponen yang disimpulkan atau diganti, dan validationGranularity dari PREMISE. Namun, uspsData tidak terisi sepenuhnya, dan tidak berisi nilai dpvConfirmation.

Alamat dimasukkan Wilayah
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 Amerika Serikat

Keputusan untuk alamat yang dikonfirmasi dengan data USPS tidak lengkap

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

Data USPS untuk alamat yang dikonfirmasi dengan data USPS tidak lengkap

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}