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

Address Validation API הוא שירות שמקבל כתובת. הוא מזהה את רכיבי הכתובת ומאמת אותם. הוא גם מסדיר את הכתובת למשלוח דואר ומוצא את קו האורך וקו הרוחב הידועים ביותר שלה. לחלופין, אפשר להפעיל את Coding Accuracy Support System‏ (CASS™) עבור כתובות בארצות הברית ובפוארטו ריקו.

למה כדאי להשתמש ב-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, לצד הנתונים שהוא מחזיר. פרטים ספציפיים זמינים במאמר העזרה של Address Validation API.

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

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

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

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

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

מידע על CASS™‎

שירות הדואר של ארצות הברית (USPS®)¹ מנהל את מערכת התמיכה בדיווח מדויק על כתובות (CASS™) כדי לתמוך בספקי אימות כתובות ולאשר אותם. שירות שקיבל אישור CASS™, כמו Address Validation API, אושר על היכולת שלו למלא מידע חסר בכתובת, לסטנדרטיזציה שלה ולעדכן אותה כדי לספק את הכתובת העדכנית והמדויקת ביותר.

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

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

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

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

---

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