טיפול בכתובות בארצות הברית

במסמך הזה מוסבר על אימות כתובות בארצות הברית:

נתוני USPS בתהליך העבודה

כשמאמתים כתובות בארצות הברית, ה-API לאימות כתובות יכול גם לאכלס את החלק uspsData של הערך המוחזר.

מכיוון שהאובייקט הזה לא תמיד מאוכלס, לא כדאי להסתמך על המאפיין הזה כדרך היחידה לאימות כתובות, אלא לשלב במערכת גם את הרכיבים verdict ו-address.

אימות נקודת מסירה (DPV) של USPS

כחלק מהתגובה uspsData, השדה dpvConfirmation מחזיר תו בודד כדי ליידע אתכם אם שירות הדואר של ארה"ב (USPS) יכול לספק את המשלוח לכתובת שצוינה.

אפשר להשתמש בשדה הזה כדי לקבוע את הפרטים הבאים:

  • תוקף הכתובת.
  • אם חסר מספר של יחידה משנית בכתובת.
  • אם מספר המשנה של המקום לא קיים במערכת הנתונים של USPS.

השירות מחזיר אחד מארבעת הערכים של dpvConfirmation או שלא מחזיר ערך של dpvConfirmation בכלל. בטבלה הבאה מוצג אופן הפעולה המומלץ שצריך להגדיר בלוגיקה שלכם לכל אחד מ-5 התוצאות האפשריות. פרטים נוספים על הלוגיקה הזו מופיעים במאמר סקירה כללית של תהליך העבודה בקטע יצירת לוגיקת האימות.

ערך

התנהגות

תיאור

לא

או ריק

תיקון הכתובת

הכתובת לא אומתה באמצעות 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 ב-Mountain View, קליפורניה, ככתובת איכותית מוכרת.

  • הכתובת שהוזנה: 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.