במסמך הזה מוסבר איך מאמתים כתובות בארה"ב:
נתוני USPS בתהליך העבודה
כשמאמתים כתובות בארצות הברית, השירות Address Validation API יכול לאכלס גם את החלק uspsData של ההחזר.
מכיוון שהאובייקט הזה לא תמיד מאוכלס, לא מומלץ להסתמך על המאפיין הזה כדרך היחידה לאימות כתובות, אלא לשלב במערכת גם את הרכיבים של התוצאה והכתובת.
USPS Delivery Point Verification (DPV)
כחלק מהתגובה uspsData, השדה dpvConfirmation מחזיר תו יחיד כדי להודיע לכם אם USPS יכולה לבצע משלוח לכתובת שציינתם.
אפשר להשתמש בשדה הזה כדי לקבוע את הפרטים הבאים:
- תקינות הכתובת.
- אם חסר בכתובת מספר של נכס משנה.
- אם מספר הנכס המשני לא קיים במערכת הנתונים של USPS.
השירות מחזיר אחד מארבעת הערכים של dpvConfirmation, או שהוא לא מחזיר ערך dpvConfirmation בכלל. בטבלה הבאה מפורטת ההמלצה לגבי ההתנהגות שהלוגיקה צריכה להשתמש בה לכל אחת מ-5 התוצאות האפשריות. לפרטים נוספים על הלוגיקה הזו, ראו סקירה כללית על תהליך העבודה בקטע שימוש בתשובה לאימות.
ערך |
התנהגות |
תיאור |
|---|---|---|
N או ריק |
תיקון הכתובת |
הכתובת לא אומתה באמצעות DPV. כלומר, שירות הדואר של ארה"ב לא מזהה את מספר הבית שהוזן ברחוב (במסלול) שהוזן, ולא ניתן לבצע שם מסירה. |
D |
תיקון הכתובת |
הכתובת אומתה על ידי DPV עבור המספר הראשי בלבד, והמידע על המספר המשני חסר. |
S |
יש לאשר את הכתובת |
הכתובת אומתה על ידי DPV רק עבור המספר הראשי, והמידע על המספר המשני היה קיים אבל לא אומת. המשמעות היא שמספר הנכס שהוזן קיים במסלול שהוזן, אבל הנכס המשני שצוין לא קיים בבניין הזה, לפי USPS. |
Y |
מאשרים את הכתובת. |
הכתובת אומתה על ידי DPV למספר הראשי ולמספרים המשניים. כלומר, אפשר לשלוח אליה חבילות באמצעות USPS, כולל מספר הנכס המשני, אם רלוונטי. |
בהמשך הקטע הזה נדון בתרחישים מציאותיים שבהם נעשה שימוש בקודים של DPV.
דוגמה ל-DPV N – תיקון הכתובת
בדוגמה הזו מצוין מספר רחוב לא קיים בכתובת תקינה.
- הכתובת שהוזנה: 12 Amphitheatre Parkway, Mountain View, CA, 94043
- אזור: ארה"ב
- השדה
dpvConfirmationמחזיר את הערך:N
זהו אות חזק במיוחד לכך שמספר הנכס הזה לא קיים במסלול הזה. כמו בכתובות בעייתיות אחרות, המערכת צריכה לבקש מהמשתמש לתקן את הכתובת.
DPV D example - fix the address
בדוגמה הזו מצוין המשרד של Google בניו יורק, אבל לא מצוין נכס משנה, שהוא חלק חובה בכתובת. כדי לראות את זה, צריך להשתמש בכתובת בדמו בלי פרטי נכס משנה.
- הכתובת שהוזנה: 111 8th Avenue, New York, NY, 10011
- אזור: ארה"ב
- השדה
dpvConfirmationמחזיר את הערך:D
זה מאשר שהנכס המשני חסר בקלט. כדי להגיע ל-DPV של Y, צריך לכלול טענת נכוֹנוּת משנית תקינה כחלק מהקלט. לדוגמה, אפשר לכלול נכס משנה תקין של FL 4 (קומה 4) כדי לקבל ערך dpvConfirmation של Y.
דוגמה ל-DPV S – אישור הכתובת
בדוגמה הזו נעשה שימוש במספר של נכס משנה שלא קיים בבניין:
- הכתובת שהוזנה: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- אזור: ארה"ב
- השדה
dpvConfirmationמחזיר את הערך:S
המשמעות היא ש-1600 Amphitheatre Parkway היא כתובת קיימת שאפשר לשלוח אליה דואר, אבל החלק 'Ste 101' הוא לא חלק תקין מהכתובת. המערכת צריכה לאמת את המידע הזה עם המשתמש ולספק לו הזדמנות לתקן אותו.
DPV Y example - accept the address
בדוגמה הזו נעשה שימוש בכתובת Googleplex ב-Mountain View, CA ככתובת ידועה באיכות גבוהה.
- הכתובת שהוזנה: 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.