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