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

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

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

כשמאמתים כתובות בארצות הברית, שירות Address Validation API יכול גם לאכלס את החלק uspsData של הנתונים המוחזרים.

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

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

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

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

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

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

ערך

התנהגות

תיאור

‫N או ריק

תיקון הכתובת

הכתובת לא אומתה באמצעות 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.

דוגמה לאימות כתובת

בדוגמה הזו נעשה שימוש במספר של מיקום משני שלא קיים בבניין:

  • הכתובת שהוזנה: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • אזור: ארה"ב
  • השדה dpvConfirmation מחזיר: S

המשמעות היא שכתובת תקינה היא 1600 Amphitheatre Parkway, אבל Suite 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.