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

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

דוגמה נפוצה: קבלה

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

הכתובת הוזנה אזור
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 Garugnale, 14 unit 2, 66054 מכיוון 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 IL

נתוני 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, פאלם ביץ' גארדנס, FL 33418-1703 IL

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