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

במאמר הזה מתוארים כמה תרחישים מהחיים האמיתיים שבהם 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. לא אושר – השירות לא יכול להתאים את מספר הרחוב 84 למערך הנתונים שלו, וסביר – נתוני הרכיב עדיין יכולים להיות תקפים.

חסר מאפיין משנה של מיקום

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