במסמך הזה מתוארים כמה תרחישים מהעולם האמיתי שבהם ה-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 Graugnale, 14 unit 2, 66054 VASTo 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 | ארה"ב |
נתוני 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, Palm חוף Garden, FL 33418-1703 | ארה"ב |
פסק דין לגבי כתובת מאושרת עם נתוני 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"
}