במסמך הזה מוסבר על אימות כתובות בארצות הברית:
נתוני USPS בתהליך העבודה שלכם
כשמאמתים כתובות בארצות הברית, ה-Address Validation API יכול גם לאכלס את החלק uspsData של התשובה.
מכיוון שהאובייקט הזה לא תמיד מאוכלס, לא כדאי להסתמך על המאפיין הזה כדרך היחידה לאימות כתובות. במקום זאת, כדאי לשלב במערכת גם את הרכיבים של פסק הדין והכתובת.
אימות נקודת מסירה (DPV) של USPS
כחלק מהתגובה uspsData, השדה dpvConfirmation מחזיר תו בודד כדי ליידע אתכם אם USPS יכולה לספק את המשלוח לכתובת שצוינה.
אפשר להשתמש בשדה הזה כדי לקבוע את הפרטים הבאים:
- תקינות הכתובת.
- אם חסר מספר של מיקום משני בכתובת.
- אם מספר המשנה של המבנה לא קיים במערכת הנתונים של 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 ב-Mountain View, קליפורניה, ככתובת איכותית מוכרת.
- הכתובת שהוזנה: 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.