Address Validation API מקבל כתובת, מזהה את הרכיבים שלה ומאמת אותם, יוצר כתובת סטנדרטית למשלוח דואר ומחזיר את הקואורדינטות הידועות הכי טובות של קו הרוחב וקו האורך שלה. בכתובות בארה"ב ובפוארטו ריקו, אפשר להפעיל עיבוד USPS CASS.
Address Validation API: עובדות חשובות
- מוצר: Address Validation API
- קטגוריה: מקומות
- פלטפורמה: שירות אינטרנט (REST)
- פועל ב: שרת (קוד לקצה העורפי)
- שלב ההשקה: GA
- מחזור חיים: פעיל
- סקירה כללית: סקירה כללית של Address Validation API
- זמינות אזורית: מוגבלת. המדינות הנתמכות ואיכות הנתונים משתנות בהתאם למדינה, וחלק מהמדינות נמצאות בגרסת טרום-השקה (Preview). מטא-נתונים של מגורים ומסחר מוחזרים רק למדינות שמסומנות בדף הכיסוי. USPS CASS נתמך רק בארה"ב ובפוארטו ריקו. (פרטי הכיסוי)
Address Validation API: מתי כדאי להשתמש בו
מתי כדאי להשתמש ב-Address Validation API:
- אתם צריכים לבדוק אם הכתובת מתייחסת למקום אמיתי ולמצוא אילו רכיבים חסרים או אולי שגויים.
- אתם צריכים להשלים כתובת למשלוח דואר ולהתאים אותה לפורמט סטנדרטי, למשל במהלך תהליך התשלום.
- צריך אימות CASS של USPS ו-
uspsDataלכתובות בארה"ב או בפוארטו ריקו. - אתם צריכים מטא-נתונים של כתובת מגורים או כתובת עסק במדינה שמופיעה בדף הכיסוי.
מתי לא להשתמש ב-Address Validation API:
- אתם רק צריכים להמיר כתובת לקווי רוחב ואורך, ולא צריכים לאמת רכיבי כתובת נפרדים. במקום זאת, צריך להשתמש ב-Geocoding API.
- אתם צריכים פרטים מקומיים מאוד על היעד, כמו כניסות לבניינים, קווי מתאר של בניינים או נקודות ניווט. במקום זאת, צריך להשתמש ב-Geocoding API.
Address Validation API: הגדרה
- השירות שצריך להפעיל:
addressvalidation.googleapis.com - אימות: מפתח API, OAuth 2.0, חשבון שירות
- תחילת העבודה: הגדרת Address Validation API
- חומר עזר: מאמרי העזרה של Address Validation API
- תמחור: שימוש וחיוב ב-Address Validation API
- כללי מדיניות: כללי המדיניות של Address Validation API
- נתוני גרסה: נתוני הגרסה של Address Validation API
חבילות Address Validation API רשמיות:
- npm:
@googlemaps/addressvalidation - pypi:
google-maps-addressvalidation - go:
cloud.google.com/go/maps
Address Validation API: טעויות נפוצות
- הבעיה: המאפיין
addressCompleteמושמט מהתוצאה כשהערך שלו הואfalse, ולכן קוד שמצפה שהשדה יהיה קיים עלול לפרש באופן שגוי כתובות חלקיות. תיקון: מתייחסים למאפייןaddressCompleteחסר כאלfalse, או בודקים אם המאפיין קיים. מידע נוסף זמין בכתובת /maps/documentation/address-validation/understand-response. - הבעיה: אם משמיטים את
regionCode, ה-API מסיק את האזור מהכתובת, מה שעלול להוביל לתוצאות פחות טובות. הפתרון: צריך לכלול אתregionCodeב-PostalAddressכשהוא ידוע. מידע נוסף זמין בכתובת /maps/documentation/address-validation/requests-validate-address. - הבעיה: לא מובטח שהאובייקט
uspsDataיאוכלס במלואו בכל כתובת מאומתת בארה"ב. הפתרון: אל תסתמכו עלuspsDataכאות האימות היחיד. השתמשו גם ברכיבי ההחלטה והכתובת. מידע נוסף זמין בכתובת /maps/documentation/address-validation/handle-us-address. - הבעיה: משוב שנשלח באמצעות
provideValidationFeedbackחייב להפנות אלresponseIdמהקריאה הראשונה ל-validateAddressברצף, ולא לקריאה מאוחרת יותר. התיקון: שומרים את ה-responseIdמהתגובה הראשונה שלvalidateAddressושולחים אותו בבקשת המשוב. מידע נוסף זמין בכתובת /maps/documentation/address-validation/handle-updated-address.
מה אפשר לעשות עם Address Validation API
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
- החזרת כתובת מאומתת לכתובת או לכתובת חלקית שצוינה.
- החזרת הקואורדינטות של קו הרוחב/האורך של כתובת מאומתת.
- החזרת מזהה המקום ב-Google של כתובת מאומתת.
- שימוש באישור של מערכת התמיכה לדיוק קידוד (CASS) של שירות הדואר של ארצות הברית (USPS) לאימות כתובות.
- החזרת מידע על כתובת מאומתת: האם מדובר בעסק, בבית מגורים או בתא דואר.
- החזרת מטא-נתונים של שירות הדואר של ארצות הברית (USPS) לגבי כתובת מאומתת.
- החזרת גרסה באנגלית של כתובת מאומתת. תצוגה מקדימה
- החזרת ה-Plus Code של כתובת מאומתת.