המסמך הזה מכיל מידע על אימות כתובות ספציפי לארה"ב:
נתוני 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.