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

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

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

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

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

קביעת סיכון לכתובת מקובלת

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

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

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

  • hasUnconfirmedComponents נשאר false
  • hasInferredComponents נשאר false
  • hasReplacedComponents נשאר false
  • hasSpellCorrectedComponents נשאר 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 לכתובת מאומתת

בדוגמה הזו רואים איך מזינים כתובת בארה"ב עם כל רכיבי הכתובת שאושרו, בלי רכיבים שהמערכת הסיקה או החליפה, ועם validationGranularity של PREMISE. עם זאת, הפרמטר 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"
}