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

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

דוגמה נפוצה: אישור

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

החלטה לגבי כתובת קבילה

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

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

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

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

השילוב של האותות האלה מצביע על כתובת איכותית.

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

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

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

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

החלטה לגבי מספר רחוב לא מאומת

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

נתוני 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 לכתובת מאומתת

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

החלטה לגבי כתובת מאומתת עם נתונים חלקיים של 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"
}