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

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

דוגמה נפוצה: accept

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

הכתובת שהוזנה אזור
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 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 חלקיים לכתובת מאומתת

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