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 mengetahui konteksnya.

Contoh umum: accept

Skenario ini mengilustrasikan alamat yang akan diterima sistem Anda yang dimasukkan oleh pelanggan.

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

Keputusan untuk alamat yang dapat diterima

Contoh di bawah menyoroti sinyal penting.

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

Selain itu, verdict menunjukkan hal berikut:

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

Jika digabungkan, sinyal ini menunjukkan alamat berkualitas tinggi.

Contoh kasus ekstrem: accept

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

Nomor jalan yang tidak dikonfirmasi di luar Amerika Serikat

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

Alamat yang dimasukkan Wilayah
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia IT

Keputusan untuk nomor jalan yang tidak dikonfirmasi

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

Penyelidikan lebih lanjut terhadap komponen alamat menunjukkan bahwa tingkat konfirmasi untuk nomor jalan adalah UNCONFIRMED_BUT_PLAUSIBLE.

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

Nomor jalan yang tidak dikonfirmasi di Amerika Serikat

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

Alamat yang dimasukkan Wilayah
975 Carson Dr, Sunnyvale, CA 94086 US

Data USPS untuk nomor jalan yang tidak 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 yang tidak lengkap untuk alamat yang dikonfirmasi

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

Alamat yang dimasukkan Wilayah
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 US

Keputusan untuk alamat yang dikonfirmasi dengan data USPS yang tidak lengkap

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

Data USPS untuk alamat yang dikonfirmasi dengan data USPS yang 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"
}