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

מפתחים באזור הכלכלי האירופי (EEA)

מבוא

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

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

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

שיקולים נוספים

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

יכול להיות ש-Geocoding API יתאים יותר לצרכים שלכם אם אתם לא צריכים לאמת את רכיבי הכתובת האישיים, או אם אתם צריכים פרטים על יעדים מקומיים מאוד, כמו כניסות לבניינים, מתארים של בניינים ונקודות ניווט.

‫Geocoding API v4 כולל את השיטה SearchDestinations שמחזירה קואורדינטות של כניסות לבניינים, נקודות ניווט ומתארים של בניינים. פרטים נוספים זמינים בקטע חיפוש יעדים ב-Geocoding API v4.

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

לצפייה בהדגמה

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

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

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

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

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