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

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

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

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

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

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

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

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

בנוסף, verdict מציין את הדברים הבאים:

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

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