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

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