תיקון כתובת – דוגמאות

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

דוגמאות נפוצות: תיקון

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

חסרים עיר ומיקוד

בדוגמה הזו מוצגת רשומה שכוללת רק את כתובת הרחוב, בלי עיר או מיקוד.

הוזנה כתובת אזור
‪21 45 40th street ארה"ב

התוצאה לגבי עיר ומיקוד חסרים

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

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true,
  "possibleNextAction": "FIX"
}

ההודעה possibleNextAction מספקת אינדיקציה ראשונית לכך שאולי לא ניתן לשלוח לכתובת. גם הרכיבים המודגשים האחרים תומכים באפשרות הזו, ולכן אפשר לשלוח שאילתה אל addressComponents כדי לקבל מידע נוסף:

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

ה-Address Validation API מחזיר רק את המדינה (ארצות הברית) בתור CONFIRMED. הפונקציה מחזירה את כל רכיבי הכתובת האחרים כ-UNCONFIRMED_BUT_PLAUSIBLE, עם השמטות חשובות מסוימות של הנתונים, כמו יישוב ומיקוד.

חסר מספר בית

בדוגמה הזו חסר מספר בית.

הוזנה כתובת אזור
‪Buckingham Palace Road, SW1W 9TQ London בריטניה
התוצאה לגבי מספר בית חסר
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE",
    "possibleNextAction": "FIX"
}

שוב, possibleNextAction מספק אינדיקציה ראשונית לכך שאולי לא ניתן לשלוח הודעות לכתובת. בנוסף, validationGranularity הוא ROUTE, מה שמצביע על התאמה לרחוב, אבל אין מספיק מידע כדי להגיע למקום. בנוסף, המאפיין addressComplete חסר בפסק הדין, ולכן הוא false. שאילתה נוספת של האובייקט address חושפת סוג רכיב חסר:

"missingComponentTypes": [
        "street_number"
      ]

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

במצבים מסוימים, הפעולה שתצטרכו לבצע (תיקון, אישור או קבלת כתובת) תלויה בתרחיש העסקי הספציפי שלכם. בדוגמאות שלמטה מפורטים תרחישים שלא בהכרח משתייכים לקטגוריה מסוימת של תיקון.

מספר רחוב לא מאומת

בתרחיש הזה, Address Validation API לא יכול לאשר את מספר הרחוב שסופק, אבל הוא מציין שהכתובת מלאה.

הוזנה כתובת אזור
‪84 Buckingham Palace Road, SW1W 9TQ, London בריטניה

ההחלטה לגבי מספר רחוב לא מאומת

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

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete" : true,
  "hasUnconfirmedComponents": true,
  "possibleNextAction": "ACCEPT"
}

כדאי לבדוק את השילוב של רמת פירוט של אימות רק לקירוב ברמת המקום עם רכיבים לא מאומתים. שאילתה של הנכס addressComponents מציגה את componentType הלא מאומתים הבאים:

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

בדוגמה הזו, הערך של confirmation_level של street_number מוגדר כ-UNCONFIRMED_BUT_PLAUSIBLE. Unconfirmed (לא אושר) – השירות לא יכול להתאים את מספר הרחוב 84 למערך הנתונים שלו, ו-plausible (סביר) – נתוני הרכיב עדיין יכולים להיות תקפים.

חסר מיקום משנה

בתרחיש הזה מתוארת כתובת שחסר בה רק מספר של יחידת משנה בנכס, כמו מספר דירה או מחלקה. אחרת, אפשר להשתמש ב-Address Validation API כדי לאמת את הכתובת באופן מלא. כמו במקרים שבהם חסר רכיב כלשהו בכתובת, הערך של addressComplete הוא false ולכן הוא לא מופיע בבדיקה ידנית של המסקנה.

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

הוזנה כתובת אזור
‪1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 ארה"ב

החלטה לגבי חוסר במבנה משנה

בדוגמה הזו, פסק הדין לא מציג את המאפיין addressComplete, ולכן הוא false. לכן אתם יודעים שלפחות רכיב אחד בכתובת לא צפוי, לא נפתר או חסר.

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

שאילתת address מגלה את הפרטים הבאים:

"missingComponentTypes": [
        "subpremise"
      ]

בבדיקה נוספת, הנתונים של USPS מספקים קוד dpvConfirmation של D, שגם הוא מציין שחסר מידע על מיקום משני.