במסמך הזה מתוארים כמה תרחישים מהעולם האמיתי ה-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 | US |
נתוני 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 | US |
פסק דין לגבי כתובת מאושרת עם נתוני 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"
}