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

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

נתוני 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 US

פסק דין לגבי כתובת מאושרת עם נתוני 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"
}