למה כדאי להשתמש בממשק ה-API לאימות כתובת
בעזרת כתובת ה-API לאימות כתובות אפשר לשפר את הצפי למסירה ולצמצם כשלים במסירה, וכך לשפר את חוויית הלקוח. כדי לעשות את זה, מזהים כתובות לא תקינות ומגבירים את המוּדעוּת למאפייני הכתובת.
אם אתם לא צריכים לאמת את רכיבי הכתובת הנפרדים, יכול להיות ש-Geocoding API יתאים יותר לצרכים שלכם. ב-Geocoding API ממירים כתובות לקואורדינטות של קו רוחב/קו אורך, ואילו ה-Address Validation API מאמת את נכונות הכתובות. להשוואה מפורטת, ראו יצירת יכולת לאימות מיקום באמצעות הפלטפורמה של מפות Google במרכז הארכיטקטורה.
מה אפשר לעשות עם ה-API לאימות כתובת
באמצעות ה-API לאימות כתובת אפשר לקבוע אם כתובת מתייחסת למקום אמיתי. אם הכתובת לא מתייחסת למקום אמיתי, ה-API יכול לזהות רכיבים שגויים שאתם יכולים להציג ללקוחות כדי לתקן אותם. לפניכם תהליך עבודה לדוגמה באמצעות ה-API:
הלקוח מזין כתובת – בתמונה הבאה מוצג טופס פשוט שמאפשר ללקוח להזין כתובת, כנראה כחלק מתהליך התשלום.
האפליקציה שולחת את הכתובת ל-API – האפליקציה מעבירה את הכתובת הזו כקלט ל-Address Validation API.
API מאמת ומאמת את הכתובת – בתגובה של ה-API, הוא מחזיר את הכתובת המלאה כפי שנקבעה על ידי ה-API, או מציין איפה חסר מידע.
הלקוח מתקן או מאשר את הכתובת המומלצת – בהתאם למה שה-API מחזיר, אפשר להציג ללקוח את ההנחיות הבאות:
הצגת כתובת מומלצת ללקוח כדי לאשר:
מבקשים מהלקוח להוסיף מידע חסר:
צריך לבקש מהמשתמש לתקן את הכתובת אם ה-API לא מצליח לאמת את הכתובת שהוזנה עקב מידע חסר או שגוי:
איך פועל ה-API לאימות כתובת
אימות הכתובת מקבל בקשת POST עם הכתובת בצורת גוף JSON. היא מפרידה את הכתובת לרכיבים הבודדים שלה, ואז מבצעת את הבדיקות והתיקונים הבאים:
- נכון – מספק בדיקות אימות ברמת הרכיב, כולל תחנות משנה, אם הן זמינות.
- הושלם – ניסיונות להסיק רכיבי כתובת חסרים או שגויים.
- פורמט תקין – ניקוי וסטנדרטיזציה של הפורמט של רכיבי כתובת.
כדאי לנסות את ההדגמה כדי לראות את ה-API לאימות כתובת בפעולה.
מקורות מידע
בטבלה הבאה מופיע סיכום של המשאבים שזמינים דרך ה-API לאימות כתובת, יחד עם הנתונים שהוא מחזיר. פרטים נוספים מופיעים במאמרי העזרה של Address Validation API.
| משאבי נתונים | הנתונים שהוחזרו |
|---|---|
|
רכיבי כתובת בפורמט JSON. מידע נוסף זמין בקטע אימות כתובת. |
כתובת מלאה ומאומתת (אם אפשר). סטטוס האימות של כל רכיב כתובת. אם הכתובת זמינה בכתובת:
מידע נוסף זמין בקטע הסבר על תגובת האימות. |
איך משתמשים בממשק ה-API לאימות כתובת
| 1 | רוצים לנסות את ההדגמה? | אפשר לעיין בהדגמה בעזרת מגוון טופסי כתובת, גם נכונים וגם שגויים. ההדגמה מספקת דרך שימושית לבדוק גם את הערכים המוחזרים מהשירות וגם את תגובת ה-API בפורמט JSON. |
| 2 | בדיקת הכיסוי | בפרטי הכיסוי אפשר לראות באילו מדינות ואזורים נתמך ה-API לאימות כתובת. |
| 3 | שנתחיל? | השלב הראשון הוא הגדרת הפרויקט ב-Google Cloud וביצוע ההוראות הבאות. |
| 4 | בקשה לאימות כתובת | כדאי להתחיל עם כתובת פשוטה, ולאחר מכן, כדי לשפר את הדיוק, אפשר להפעיל CASS (לכתובות בארה"ב ולכתובות ציבוריות בלבד). מידע נוסף זמין בקטע בקשה לאימות כתובת. |
| 5 | עיבוד תשובה | התגובה של Address Validation API מספקת שני מאפיינים, שבכל אחד מהם נעשה שימוש בדרכים שונות. כדאי לעיין בקטע הסבר על תגובה בסיסית. |
| 6 | שיפור רמת הדיוק של האימות | כדי לעזור לשפר את הדיוק של הכתובות, אפשר לשלוח משוב על התשובות מה-API לאימות כתובות. איך מטפלים בכתובות שעודכנו |
ספריות לקוח זמינות
במאמר ספריות לקוח תוכלו למצוא רשימה של ספריות הלקוח שזמינות ל-Address Validation API.
מידע על CASSTM
שירות הדואר של ארצות הברית (USPS®)1 פועל במסגרת מערכת התמיכה לדיוק קידוד (CASSTM), כדי לתמוך בספקים של אימות כתובות ולאשר אותם. אישרנו את היכולת של שירות CASS CertifiedTM , כמו כתובת ה-API לאימות כתובת, למלא מידע שחסר בכתובת, לקבוע תקן ולעדכן אותו כך שתספק את הכתובת הכי עדכנית והמדויקת ביותר.
CASS לא מופעל כברירת מחדל ונתמך רק באזורים US ו-PR. כדי להפעיל CASS, מגדירים את enableUspsCass לערך true כחלק מבקשת אימות. מידע נוסף זמין במאמר אימות כתובת.
כחלק מהשימוש שלנו בשירותי USPS, מערכת USPS בודקת בקשות לכתובות שנוצרו באופן מלאכותי. אם USPS מזהה כתובת קלט שנוצרה באופן מלאכותי, Google נדרשת להפסיק את אימות הכתובות עבור הלקוח, וחייבת לדווח ל-USPS על הפרטים ליצירת קשר של הלקוח (שם וכתובת), כתובת הקלט הרלוונטית ונתוני שימוש מצטברים. השימוש ב-API מבטא את הסכמתך לתנאים הספציפיים לשירות.
מה עושים אחר כך
- עיון בשאלות הנפוצות: מעבר אל שאלות נפוצות
- בדיקת האזורים הכיסוי: עוברים אל פרטי הכיסוי של המדינות והאזורים
- עיבוד כתובות בנפח גבוה: עוברים לקטע שימוש ב-API לאימות כתובות כדי לעבד כתובות בנפח גבוה.
-
הפלטפורמה של מפות Google היא בעל רישיון לא בלעדי של Postal Service® בארצות הברית. הסימנים המסחריים הבאים נמצאים בבעלות Postal Service® של ארצות הברית ומשתמשים בהם עם הרשאה: United States Postal Service® , CASSTM, CASS CertifiedTM. ↩