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

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