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

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

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

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

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

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

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

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

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

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

האותות האלה מצביעים על כתובת שלא ניתן לשלוח אליה, ולכן אפשר לשלוח שאילתה אל 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"
}

הערך של 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
}

כדאי לבדוק את השילוב של רמת פירוט של אימות רק לקירוב ברמת המקום עם רכיבים לא מאומתים. שאילתה של הנכס 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

}

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

"missingComponentTypes": [
        "subpremise"
      ]

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