סקירה כללית על כתובת 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. המערכת מפרידה את הכתובת לרכיבים נפרדים, ואז מנסה לבצע את הפעולות הבאות:

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

משאבים

בטבלה הבאה מופיע סיכום של המשאבים שזמינים דרך 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®)1 מנהל את מערכת התמיכה בדיווח מדויק על כתובות (CASS™) כדי לתמוך בספקי אימות כתובות ולאשר אותם. שירות שקיבל אישור CASS™, כמו Address Validation API, אושר על היכולת שלו למלא מידע חסר בכתובת, לסטנדרטיזציה שלה ולעדכן אותה כדי לספק את הכתובת העדכנית והמדויקת ביותר.

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

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

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


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