הוספת מבנה משנה לכתובת – דוגמאות (ארה"ב בלבד)

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

דוגמה נפוצה: הוספת מתחמים משניים

התרחיש הזה ממחיש כתובת שבה המערכת עשויה לבקש מהלקוח להוסיף מספר דירה לכתובת.

הכתובת שהוזנה אזור
1450 Brickell Avenue, Miami, FL 33131-4065 ארה"ב

תוצאה של כתובת ללא נכס משנה

הדוגמה הבאה מדגישה את האות החשוב.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

דוגמה למקרה קצה: הוספת נכסי משנה

הדוגמה הבאה מתייחסת למצב שבו הערך verdict מציין בעיות באיכות הכתובת שדורשות בדיקה נוספת. הדוגמאות האלה גם ממחישות איך הלוגיקה יכולה לעבור מהפסק הדין לרכיבי הכתובת כדי לקבל תמונה מלאה יותר ולשפר את הלוגיקה של המערכת.

חסרים טענות נחותות ורכיבים ששוערו והוחלפו

בדוגמה הזו מוצגת כתובת בארה"ב עם חסרה יישוב ומספר מיקוד שגוי.

הכתובת שהוזנה אזור
1450 Brickell Avenue, FL 33132-4065 ארה"ב

תוצאה של טענות נחותות חסרות ורכיבים ששוחזרו והוחלפו

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "hasReplacedComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

בדיקה נוספת של רכיבי הכתובת מראה שהיישוב נגזר והמיקוד הוחלף.

{
   "componentName": {
     "text": "33131",
   }
   "componentType": "postal_code",
   "confirmationLevel": "CONFIRMED",
   "replaced": true
},
{
   "componentName": {
     "text": "Miami",
     "languageCode": "en"
   }
   "componentType": "locality",
   "confirmationLevel": "CONFIRMED",
   "inferred": true
}