במסמך הזה מוסבר על אימות כתובות בארצות הברית:
נתוני USPS בתהליך העבודה שלכם
כשמאמתים כתובות בארצות הברית, ה-Address Validation API יכול גם לאכלס את החלק uspsData של התשובה.
האובייקט הזה לא תמיד מאוכלס, ולכן לא כדאי להסתמך על המאפיין הזה כאמצעי היחיד לאימות כתובות. במקום זאת, כדאי לשלב במערכת גם את רכיבי הכתובת וההחלטה.
אימות נקודת מסירה (DPV) של USPS
כחלק מהתשובה של uspsData, השדה dpvConfirmation מחזיר תו בודד כדי ליידע אתכם אם שירות הדואר של ארה"ב יכול לשלוח לכתובת שצוינה.
אתם יכולים להשתמש בשדה הזה כדי לקבוע את הדברים הבאים:
- תקינות הכתובת.
- אם חסר מספר משנה של מבנה בכתובת.
- אם מספר המשנה של המבנה לא קיים במערכת הנתונים של USPS.
השירות מחזיר אחד מתוך ארבעה ערכי dpvConfirmation, או לא מחזיר ערך dpvConfirmation בכלל. בטבלה הבאה מוצגת ההתנהגות המומלצת שהלוגיקה שלכם צריכה להשתמש בה לכל אחת מ-5 התוצאות האפשריות. למידע נוסף על הלוגיקה הזו, קראו את סקירה כללית על תהליך העבודה בקטע בניית לוגיקת האימות.
ערך |
התנהגות |
תיאור |
|---|---|---|
לא או ריק |
תיקון הכתובת |
הכתובת לא אומתה באמצעות DPV. זה אומר שרשות הדואר של ארה"ב לא מזהה את מספר הבית שהוזן ברחוב (המסלול) שהוזן, ולא יכולה לשלוח לשם. |
D |
תיקון הכתובת |
הכתובת אומתה ב-DPV רק למספר הראשי, והמידע על המספר המשני היה חסר. |
S |
יש לאשר את הכתובת |
הכתובת אומתה באמצעות DPV רק למספר הראשי, והמידע על המספר המשני היה קיים אבל לא אומת. כלומר, מספר המבנה שהוזן קיים בנתיב שהוזן, אבל לפי USPS, המשנה-מבנה שצוין לא קיים בבניין הזה. |
Y |
מאשרים את הכתובת. |
הכתובת אומתה באמצעות 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 (קומה 4) כדי לקבל ערך Y ב-dpvConfirmation.
דוגמה ל-DPV S – אישור הכתובת
בדוגמה הזו נעשה שימוש במספר של יחידת משנה שלא קיים בבניין:
- הכתובת שהוזנה: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- אזור: ארה"ב
- השדה
dpvConfirmationמחזיר:S
זה מציין שהכתובת 1600 Amphitheatre Parkway קיימת ויכולה לקבל דואר, אבל החלק Ste 101 לא תקין. המערכת שלכם צריכה לאשר את המידע הזה עם המשתמש ולתת לו הזדמנות לתקן אותו.
דוגמה ל-DPV Y – קבלת הכתובת
בדוגמה הזו, הכתובת של Googleplex במאונטיין ויו, קליפורניה, משמשת ככתובת איכותית ידועה.
- הכתובת שהוזנה: דיזנגוף 50, תל אביב-יפו, 64332, ישראל
- אזור: ארה"ב
- השדה
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.