סקירה כללית על כתובת Validation API

ה-Address Validation API הוא שירות שמקבל כתובת. הוא מזהה את רכיבי הכתובת ומאמת אותם. הוא גם מבצע סטנדרטיזציה של הכתובת למשלוח דואר ומוצא את הקואורדינטות המוכרות ביותר של קווי אורך ורוחב. אפשר גם להפעיל את מערכת התמיכה לדיוק קידוד (CASSTM) בכתובות בארצות הברית ובפוארטו ריקו.

למה כדאי להשתמש ב-Address Validation API

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

אם אתם לא צריכים לאמת את רכיבי הכתובת הנפרדים, יכול להיות ש-Geocoding API יתאים יותר לצרכים שלכם. ה-Geocoding API ממיר כתובות לקואורדינטות של קווי רוחב/אורך, בעוד ש-Address Validation API מאמת את הכתובות. להשוואה מפורטת, אפשר לעיין במאמר בניית יכולת אימות מיקום באמצעות הפלטפורמה של מפות Google במרכז הארכיטקטורה.

מה אפשר לעשות עם Address Validation API

באמצעות ה-Address Validation API אפשר לקבוע אם כתובת מפנה למקום אמיתי. אם הכתובת לא מפנה למקום אמיתי, ה-API יכול לזהות רכיבים שגויים שתוכלו להציג ללקוחות ולתקן אותם. הנה תהליך עבודה לדוגמה באמצעות ה-API:

1. הלקוח מזין כתובת – בתמונה הבאה מוצג טופס פשוט שמאפשר ללקוח להזין כתובת, גם כחלק מתהליך התשלום.
   

2. האפליקציה שולחת את הכתובת ל-API – האפליקציה מעבירה את הכתובת הזו כקלט ל-Address Validation API.

3. API מאמת את הכתובת ומתקן אותה – בתגובה שלו, ה-Address Validation API מחזיר את הכתובת המלאה כפי שנקבע על ידי ה-API, או מציין איפה חסר מידע.

4. הלקוח מתקן או מאשר את הכתובת המומלצת – בהתאם למה שה-API מחזיר, אפשר לשלוח ללקוח את ההנחיות הבאות:

   • הצגת כתובת מומלצת ללקוח כדי לאשר:
     

   • מבקשים מהלקוח להוסיף את הפרטים החסרים:
     

   • אם ה-API לא מצליח לאמת את הכתובת שהוזנה עקב מידע חסר או שגוי, תוצג למשתמש בקשה לתיקון הכתובת:
     

איך פועל ה-Address Validation API

אימות הכתובת מקבל בקשת POST עם כתובת בצורת גוף JSON. היא מפרידה את הכתובת לרכיבים הנפרדים שלה, ואז מבצעת את הבדיקות והתיקונים הבאים:

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

אפשר לנסות את ההדגמה כדי לראות איך ה-Address Validation API פועל.

משאבים

בטבלה הבאה מוצג סיכום של המשאבים שזמינים דרך Address Validation API, יחד עם הנתונים שהוא מחזיר. לפרטים ספציפיים, קראו את חומר העזר בנושא URL Validation API.

משאבי נתונים	הנתונים הוחזרו
רכיבי כתובת בפורמט JSON. למידע נוסף, ראו אימות כתובת.	כתובת מלאה ומאומתת (אם אפשר). סטטוס אימות של כל רכיב כתובת. אם הכתובת זמינה: קואורדינטות דיוק הכתובת נתונים של שירותי הדואר, אם הם זמינים. אפשר לקרוא מידע נוסף בקטע הסבר על תגובת האימות.

איך משתמשים ב-Address Validation API

1	להתנסות בהדגמה	כדאי לבדוק את ההדגמה בעזרת מגוון טופסי כתובת, גם נכונים וגם שגויים. ההדגמה מספקת דרך שימושית לבדוק גם את הערכים המוחזרים מהשירות וגם את תגובת ה-API בפורמט JSON.
2	בדיקת הכיסוי	אפשר לעיין בפרטי הכיסוי כדי לראות באילו מדינות ואזורים אפשר להשתמש ב-Address Validation API.
3	להגדרה	מתחילים בהגדרת הפרויקט ב-Google Cloud ופועלים לפי ההוראות הבאות.
4	בקשה לאימות כתובת	כדאי להתחיל עם כתובת פשוטה, ואז, כדי לשפר את הדיוק, אפשר להפעיל CASS (לכתובות בארה"ב ובכתובות PR בלבד). למידע נוסף, ראו בקשה לאימות כתובת.
5	עיבוד תשובה	התשובה Address Validation API מספקת שני מאפיינים, שבכל אחד מהם ניתן להשתמש בדרכים שונות. אפשר להיעזר במאמר הסבר על תשובה בסיסית.
6	שיפור רמת הדיוק של האימות	כדי לעזור לשפר את הדיוק של הכתובות, אפשר לשלוח משוב על תשובות מה-Address Validation API. למידע נוסף, ראו כתובות אימייל מעודכנות.

ספריות לקוח זמינות

בספריות הלקוח תוכלו למצוא רשימה של ספריות הלקוח הזמינות ל-Address Validation API.

מידע על CASSTM

שירות הדואר בארצות הברית (USPS®)¹ מנהל את מערכת התמיכה לדיוק קידוד (CASSTM) תיקוף לתמיכה ולאישור כתובות. ראינו ששירות CASS CertifiedTM , כמו Address Validation API, יכול למלא מידע שחסר בכתובת מסוימת, לקבוע תקן ולעדכן אותה כדי לספק את הכתובת העדכנית והמדויקת ביותר.

שירות CASS לא מופעל כברירת מחדל ונתמך רק באזורי US ו-PR. כדי להפעיל CASS, צריך להגדיר את enableUspsCass לערך true כחלק מבקשת אימות. מידע נוסף זמין במאמר אימות כתובת.

כחלק מהשימוש שלנו בשירותי USPS, המערכת של USPS בודקת בקשות לכתובות שנוצרו באופן מלאכותי. אם ב-USPS מזוהה כתובת קלט שנוצרה באופן מלאכותי, Google נדרשת להפסיק לאמת את הכתובות של הלקוח, וצריך לדווח ל-USPS על הפרטים ליצירת קשר של הלקוח (שם וכתובת), על הכתובת הרלוונטית לקלט ועל נתוני השימוש הנצברים. השימוש ב-API מבטא את הסכמתך לתנאים הספציפיים לשירות.

המאמרים הבאים

• עיון בשאלות הנפוצות: מעבר אל שאלות נפוצות
• בדיקת אזורי הכיסוי: עוברים אל פרטי הכיסוי לפי מדינות ואזורים.
• עיבוד כתובות בנפח גדול: עוברים למאמר שימוש ב-Address Validation API לעיבוד כתובות בנפח גדול.

---

1. הפלטפורמה של מפות Google היא בעל רישיון לא בלעדי של שירות הדואר של ארצות הברית. הסימנים המסחריים הבאים הם בבעלות שירות הדואר של ארצות הברית, שנעשה בהם שימוש באישור: United States Postal Service® , CASSTM, CASS CertifiedTM. ↩