המסמך הזה מכיל מידע על אימות כתובות ספציפי לארה"ב:
נתוני 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 (4th Floor) כדי לקבל את הערך 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 לא מציין אם ה-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.