ה-Address Authentication API הוא שירות שמקבל כתובת, מזהה את רכיבי הכתובת ומאמת אותם. כמו כן, הוא מתקן את הכתובת למשלוח דואר רגיל, ומוצא את המיקום הטוב ביותר של קווי אורך ורוחב. קל יותר להבין אם כתובת מתייחסת למקום אמיתי. אם הכתובת לא מתייחסת למקום אמיתי, היא יכולה לזהות רכיבים שגויים, וכך לאפשר למשתמשים לתקן אותם.
ה-API לאימות כתובות מספק תכונות רבות שיעזרו לכם לעבד כתובת, כולל:
מפרידה את הכתובת לרכיבים שלה ולאחר מכן מספקת בדיקות אימות ברמת הרכיב, כולל סביבות משנה (אם יש).
מנקה, מתקן ומסיק את רכיבי הכתובת החסרים או השגויים.
המערכת משלימה את הכתובת ומספקת מידע נוסף, כולל קוד גיאוגרפי, דיוק הכתובת ונתוני שירותי דואר.
מחזירה מחרוזת אחת המכילה את הכתובת המלאה, כפי שנקבע על ידי ה-API.
אפשר לנסות את ההדגמה כדי לראות את ה-API לאימות כתובות בפעולה.
הוספת ה-API לאימות כתובות לתהליך העבודה
אחד מהתרחישים הנפוצים ביותר לגבי 'אימות כתובת', הוא שיפור חוויית הלקוח בכך שהוא מבטיח שהלקוח יזין כתובת נכונה. אימות הכתובת עוזר לצמצם את הכשלים של המסירה על ידי זיהוי כתובות שגויות, ולשפר את יכולת המסירה באמצעות מוּדעוּת טובה יותר למאפייני הכתובת.
התמונה הבאה מציגה טופס פשוט שמאפשר ללקוח להזין כתובת, כנראה כחלק מתהליך התשלום. להעביר את הכתובת הזו בתור הקלט ל-API לאימות כתובות.
בתשובה שלו, ה-API לאימות כתובת מחזיר את הכתובת המלאה, שנקבעת על ידי ה-API. מציגים את הכתובת המלאה ללקוח ככתובת המומלצת:
אם ה-API לאימות כתובות חסר מידע, מבקשים מהמשתמש להוסיף אותו:
אם ל-API אין אפשרות לאמת את כתובת הקלט עקב מידע חסר או שגוי, בקשו מהמשתמש לתקן את הכתובת:
ההבדלים בין API לאימות כתובות ל-API של קידוד גיאוגרפי
ממשק ה-API לקידוד גיאוגרפי וממשק ה-API לאימות כתובות מנסים לענות על השאלה "מהו המיקום הטוב ביותר לקלט של משתמש זה?" בניגוד ל-API לקידוד גיאוגרפי, ה-API לאימות כתובות מנסה גם:
- עונים על השאלה "האם קלט המשתמש הזה מייצג כתובת אמיתית?"
- הבנת כתובת הקלט גם אם לא ניתן להתאים חלקים ממנה לנתונים זמינים
- שליחת משוב על החוקיות של רכיבים שונים
- בודקים אם הכתובת הושלמה ומסמנים את כל הרכיבים החסרים
- יש להזין את הכתובת שהוחזרה במיוחד לצורך שליחה בדואר
לדוגמה, בהינתן כתובת כמו "רחוב קינג 123, תל אביב, ישראל", ה-API לקידוד גיאוגרפי פשוט יחזיר קוד גיאוגרפי של העיר Mountain View, CA והתעלם מ-"" 123 Fake St" מפני שאין רחוב כזה (או רחוב בשם דומה) ב-Mountain View.
מצד שני, 'API לאימות כתובות' יכול לזהות שהמספר '123' הוא מספר רחוב, 'רחוב מזויף' הוא רחוב והוא מחזיר תוצאה שמכילה את הרכיבים האלה וסומן אותם כ'לא מאושרים', ונותן לכם אינדיקציה מדוע הכתובת לא מצליחה לקוד גיאוגרפי.
מידע על CASSTM
The United Postal Service® (USPS®)1 מתחזק את Coding Accuracy Support System (CASSTM) לתמיכה ולאישור של ספקי אימות שירות TMCASS Certified, כגון ה-API לאימות כתובות, אושר כדי לוודא שהוא מלא מידע שחסר בכתובת מסוימת, לתקן אותו ולעדכן אותו לפי הכתובת העדכנית והמדויקת ביותר.
CASS אינו מופעל כברירת מחדל והוא נתמך רק באזורים "US" ו-"PR". כדי להפעיל את CASS, צריך להגדיר את enableUspsCass כ-true כחלק מבקשת אימות. מידע נוסף זמין במאמר אימות כתובת.
כחלק מהשימוש שלנו בשירותי USPS, הצוות של USPS מעריך בקשות לכתובות שנוצרו באופן מלאכותי. אם USPS מזהה כתובת קלט שנוצרה באופן מלאכותי, Google נדרשת להפסיק את אימות הכתובות של הלקוח ועליה לדווח ל-USPS על הפרטים ליצירת קשר של הלקוח (שם וכתובת), על כתובת הקלט הרלוונטית ועל נתוני השימוש המצטברים. השימוש ב-API מבטא את הסכמתך לתנאים הספציפיים לשירות.
המאמרים הבאים
- כדאי לנסות את ההדגמה
- שאלות נפוצות
- פרטי הכיסוי של המדינה והאזור
- הגדרה ב-Cloud Console
- קבלת מפתח API
- ספריות לקוח
-
הפלטפורמה של מפות Google היא רישיון לא בלעדי של United States Postal Service®. הסימנים המסחריים הבאים הם בבעלות של United States Postal Service® ונמצאים בשימוש בהרשאה: United States Postal Service® , CASSTM, CASS CertifiedTM. ↩