מסמך זה עוסק באימות כתובות ספציפיות לארה"ב:
נתוני USPS בתהליך העבודה
כשמאמתים כתובות בארצות הברית, השירות Address Validation API יכול גם לאכלס את החלק uspsData בהחזרה.
מכיוון שהאובייקט הזה לא תמיד מאוכלס, לא כדאי להסתמך על המאפיין הזה כאמצעי היחיד לאימות כתובות, אלא לשלב גם את התוצאה ואת רכיבי הכתובת במערכת.
אימות נקודת מסירה ב-USPS (DPV)
כחלק מהתשובה של uspsData, השדה dpvConfirmation מחזיר תו יחיד כדי ליידע אתכם אם ה-USPS יכול לספק לכתובת שצוינה.
ניתן להשתמש בשדה הזה כדי לבדוק את הדברים הבאים:
- תקינות הכתובת.
- אם חסר מספר של נכס משנה בכתובת.
- אם מספר תת-הבסיס לא קיים במערכת הנתונים של USPS.
השירות מחזיר אחד מתוך ארבעה ערכים של dpvConfirmation או לא מחזיר ערך dpvConfirmation בכלל. בטבלה הבאה מוצגת ההתנהגות המומלצת לכל אחת מ-5 התוצאות האפשריות. לפרטים נוספים על הלוגיקה הזו, ראו סקירה כללית על תהליך העבודה במאמר שימוש בתגובת האימות.
ערך |
התנהגות |
תיאור |
|---|---|---|
N או ריק |
תיקון הכתובת |
הכתובת לא אושרה במסגרת DPV. המשמעות היא ששירות ה-USPS לא מזהה את מספר הבניין שהוזן שנמצא ברחוב שהוזן (המסלול), ולא יכול לספק משלוחים משם. |
D |
תיקון הכתובת |
הכתובת אושרה במסגרת DPV של המספר הראשי בלבד, והפרטים של המספר המשני היו חסרים. |
S |
יש לאשר את הכתובת |
הכתובת אושרה באמצעות DPV של המספר הראשי בלבד, ופרטי המספר המשני היו קיימים אבל לא אושרו. המשמעות היא שמספר הנחת המוצא שהוזן קיים במסלול שהוזן, אבל ההנחה המשנית שצוינה לא קיימת בבניין הזה, לפי USPS. |
כן |
אישור הכתובת |
הכתובת אושרה במסגרת DPV של מספרים ראשיים ומשניים. המשמעות היא שהכתובת נמסרת במלואה על ידי USPS, כולל מספר תת-המשרד, אם רלוונטי. |
שאר סעיף זה דן בתרחישים מהעולם האמיתי המשתמשים בקודי DPV.
דוגמה ל-DPV N - תיקון הכתובת
בדוגמה הזו נעשה שימוש במספר רחוב לא קיים בכתובת חוקית אחרת.
- הכתובת שהוזנה: 12 Amphitheatre Parkway, Mountain View, CA, 94043
- אזור: ארה"ב
- השדה
dpvConfirmationיחזיר את הערךN
זה אות משמעותי מאוד לכך שמספר הבסיס הזה לא קיים במסלול הזה. כמו בכתובות בעייתיות אחרות, המערכת צריכה לבקש מהמשתמש לבצע תיקונים.
דוגמה ל-DPV D – תיקון הכתובת
בדוגמה הזו נשתמש במשרד של Google בניו יורק, אבל הוא לא מכיל מבנה משנה שהוא חלק נדרש מהכתובת. אפשר לראות זאת באמצעות הכתובת בהדגמה, ללא מידע על תת-בסיס.
- הכתובת שהוזנה: 111 8th Avenue, New York, NY, 10011
- אזור: ארה"ב
- השדה
dpvConfirmationיחזיר את הערךD
זהו אישור לכך שהנחת המשנה הייתה חסרה בקלט. כדי להגיע ל-DPV של Y, הקלט צריך לכלול הנחת משנה חוקית כחלק מהקלט. לדוגמה, אפשר לכלול הנחת משנה תקפה של FL 4 (4th Floor) כדי לקבל ערך dpvConfirmation של Y.
דוגמה ל-DPV S - עליך לאשר את הכתובת
בדוגמה הבאה נעשה שימוש במספר של מבנה משנה שאינו קיים בתוך הבניין:
- הכתובת שהוזנה: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- אזור: ארה"ב
- השדה
dpvConfirmationיחזיר את הערךS
פירוש הדבר הוא שלמרות שהכתובת 1600 Amphitheatre Parkway קיימת ככתובת שבה אפשר לקבל דואר, מבנה המשנה Ste 101 אינו חלק חוקי של הכתובת. המערכת שלכם צריכה לאשר את המידע הזה מול המשתמש ולספק הזדמנות לתיקון.
דוגמה ל-DPV Y - אישור הכתובת
בדוגמה הזו נשתמש בכתובת Googleplex במאונטיין ויו, קליפורניה בתור כתובת איכות ידועה.
- הכתובת שהוזנה: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
- אזור: ארה"ב
- השדה
dpvConfirmationיחזיר את הערךY
הכתובת ניתנת להעברה באופן מלא על ידי USPS. כך תוכלו להיות בטוחים מאוד שה-API החזיר כתובת באיכות טובה, ותוכלו להשתמש בו כפי שהוא.
הערה: ה-DPV לא מציין אם ב-Address Validation API בוצעו שינויים בקלט, כמו תיקון איות.
הודעות אבטחה לכתובות בארה"ב
בקטע הזה מתוארים דגלי האבטחה שסופקו בנתוני USPS עבור כתובות שנוצרו באופן מלאכותי. אמצעי האבטחה הזה נועד למנוע יצירה מלאכותית של רשימת כתובות, על ידי זיהוי מקרים שבהם כתובת שנשלחה נראית כאילו נבנתה באופן מלאכותי ולא הושגה באופן חוקי. מדובר במצב נדיר מאוד.
כשה-USPS מזהה כתובת שנוצרה באופן מלאכותי, השדה errorMessage במאפיין uspsData של התגובה מכיל הודעת שגיאה שמתארת את הבעיה. למשל:
AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.