במסמך הזה מתוארים מספר תרחישים מהעולם האמיתי שבהם ה-Address Validation API מספק אותות תגובה שמחייבים התנהגות אישור במערכת. למידע הקשר, ראו סקירה כללית על תהליך העבודה במאמר שימוש בתגובת האימות.
דוגמה נפוצה: קבלה
בתרחיש הזה מתואר כתובת שבה המערכת שלכם יכולה לקבל כתובת שהוזנה על ידי לקוח.
הכתובת הוזנה | אזור |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ | בריטניה |
החלטה לגבי כתובת קבילה
בדוגמה הבאה מודגשים האותות החשובים.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
בנוסף, התשובה כוללת את הפרטים הבאים:
- הערך של
hasUnconfirmedComponents
נשארfalse
- הערך של
hasInferredComponents
נשארfalse
- הערך של
hasReplacedComponents
נשארfalse
כשמשלבים את הנתונים האלה ביחד, האותות האלה מציינים כתובת איכותית.
דוגמאות לאותיות קצה: קבלה
הדוגמאות הבאות מתארות מצבים שבהם verdict
מציין טיפול בבעיות איכות שדורשות בדיקה נוספת. הדוגמאות האלה גם ממחישות איך הלוגיקה יכולה לעבור מתוצאה לרכיבי הכתובת כדי לקבל תמונה מלאה יותר ולשפר את הלוגיקה של המערכת.
מספר רחוב לא מאושר מחוץ לארה"ב
בדוגמה הזו מתוארת רשומה של כתובת איטלקית שבה כל רכיבי הכתובת קיימים, ללא רכיבים משוערים או מוחלפים. עם זאת, הערך validationGranularity
הוא ROUTE
.
הכתובת הוזנה | אזור |
---|---|
Via Fonte Garugnale, 14 unit 2, 66054 מכיוון CH, Italia | IT |
החלטה לגבי מספר בית לא מאומת
{
"inputGranularity": "SUB_PREMISE",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"addressComplete": true,
"hasUnconfirmedComponents": true
}
חקירה נוספת של רכיבי הכתובת חושפת שמספר הרחוב הוא UNCONFIRMED_BUT_PLAUSIBLE
.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
מספר רחוב לא מאומת בארה"ב
בדוגמה הזו מתוארת רשומה של כתובת בארה"ב שבה כל רכיבי הכתובת קיימים, ללא רכיבים משוערים או מוחלפים. עם זאת, הערך validationGranularity
הוא PREMISE_PROXIMITY
.
הכתובת הוזנה | אזור |
---|---|
975 Carson Dr, Sunnyvale, CA 94086 | IL |
נתוני USPS עבור מספר רחוב לא מאומת
{
"firstAddressLine": "975 CARSON DR",
"cityStateZipAddressLine": "SUNNYVALE CA 94086",
"city": "SUNNYVALE",
"state": "CA",
"zipCode": "94086"
"dpvConfirmation": "N",
"dpvFootnote": "AAM3",
"carrierRoute": "C031",
"carrierRouteIndicator": "D",
"postOfficeCity": "SUNNYVALE",
"postOfficeState": "CA",
"fipsCountyCode": "085",
"county": "SANTA CLARA",
}
נתוני USPS חלקיים לכתובת שאושרה
בדוגמה הזו מוצגת רשומה של כתובת בארה"ב שבה כל רכיבי הכתובת אושרו, ללא רכיבים חזויים או מוחלפים, ו-validationGranularity
של PREMISE
. עם זאת, השדה uspsData
לא מאוכלס במלואו ולא מכיל ערך dpvConfirmation
.
הכתובת הוזנה | אזור |
---|---|
155 Via Condado Way, פאלם ביץ' גארדנס, FL 33418-1703 | IL |
תוצאה לגבי כתובת מאושרת עם נתוני USPS חלקיים
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
נתוני USPS עבור כתובת מאושרת עם נתוני USPS חלקיים
{
"standardizedAddress": {
"firstAddressLine": "155 VIA CONDADO WAY",
"cityStateZipAddressLine": "PALM BEACH GARDENS",
"city": "PALM BEACH GARDENS",
"state": "FL",
"zipCode": "33418"
},
"carrierRoute": "H018",
"postOfficeCity": "PALM BEACH GARDENS",
"postOfficeState": "FL"
}