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