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

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

כשמשלבים את האותות האלה, הם מצביעים על כתובת באיכות גבוהה.

דוגמאות למקרי קצה: accept

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