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

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