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

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