מדריך מקוצר ל-Address Validation API

‫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: הגדרה

חבילות 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

במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.