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