אישור כתובת – דוגמאות

במסמך הזה מתוארים כמה תרחישים מהעולם האמיתי שבהם ה-Address Validation API מספק אותות תגובה שמחייבים התנהגות מקובלת מהמערכת שלכם. לקבלת הקשר, תוכלו לעיין בקטע סקירה כללית על תהליך העבודה במאמר שימוש בתשובה לאימות.

דוגמה נפוצה: accept

התרחיש הזה מדגים כתובת שהמערכת תקבל אם הלקוח יזין אותה.

הכתובת שהוזנה אזור
76 Buckingham Palace Road, London SW1W 9TQ בריטניה

תוצאה של כתובת תקינה

בדוגמה הבאה מודגשים האותות החשובים.

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

בנוסף, התגובה מציינת את הפרטים הבאים:

  • hasUnconfirmedComponents נשאר false
  • hasInferredComponents נשאר false
  • hasReplacedComponents נשאר false

כשהאותות האלה משולבים יחד, הם מצביעים על כתובת באיכות גבוהה.

דוגמאות למקרי קצה: אישור

הדוגמאות הבאות מתייחסות למצבים שבהם הערך verdict מציין בעיות באיכות הכתובת שצריך לבדוק לעומק. הדוגמאות האלה גם ממחישות איך הלוגיקה יכולה לעבור מהפסק הדין לרכיבי הכתובת כדי לקבל תמונה מלאה יותר ולשפר את הלוגיקה של המערכת.

מספר בית שלא אושר על ידי ארה"ב

הדוגמה הזו ממחישה הוספה של כתובת באיטליה עם כל רכיבי הכתובת, ללא רכיבים ששוערו או הוחלפו. אבל הערך של validationGranularity הוא ROUTE.

הכתובת שהוזנה אזור
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia IT

גזר הדין של מספר הרחוב שלא אושר

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

בדקתי את רכיבי הכתובת וגיליתי שמספר הרחוב הוא UNCONFIRMED_BUT_PLAUSIBLE.

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

מספר רחוב לא מאומת בארה"ב

בדוגמה הזו מוצגת כתובת בארה"ב עם כל רכיבי הכתובת, ללא רכיבים ששוערו או הוחלפו. עם זאת, הערך של validationGranularity הוא PREMISE_PROXIMITY.

הכתובת שהוזנה אזור
975 Carson Dr, Sunnyvale, CA 94086 ארה"ב

נתוני USPS עבור מספר רחוב לא מאומת

{
   "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",
}

נתוני USPS חלקיים לגבי כתובת שאושרה

בדוגמה הזו מוצגת כתובת בארה"ב שבה כל רכיבי הכתובת אושרו, ללא רכיבים ששוערו או הוחלפו, ועם הערך PREMISE ב-validationGranularity. עם זאת, השדה uspsData לא מאוכלס במלואו ואין בו ערך dpvConfirmation.

הכתובת שהוזנה אזור
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 ארה"ב

תוצאה של כתובת מאומתת עם נתוני USPS חלקיים

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

נתוני USPS לכתובת מאומתת עם נתוני USPS חלקיים

{
  "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"
}