يوضّح هذا المستند عددًا من السيناريوهات الواقعية التي تقدّم فيها واجهة Address Validation API إشارات استجابة تضمن سلوك قبول من نظامك. اطّلِع على أمثلة على سير العمل في إنشاء منطق التحقّق من الصحة للحصول على السياق.
مثال شائع: قبول
يوضّح هذا السيناريو عنوانًا سيقبل نظامك إدخاله من قِبل أحد العملاء.
تم إدخال العنوان | المنطقة |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ | المملكة المتحدة |
نتيجة العنوان المقبول
يوضّح المثال أدناه الإشارات المهمة.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
بالإضافة إلى ذلك، يشير الردّ إلى ما يلي:
hasUnconfirmedComponents
متبقّيةfalse
hasInferredComponents
متبقّيةfalse
hasReplacedComponents
متبقّيةfalse
hasSpellCorrectedComponents
متبقّيةfalse
وعند جمعها معًا، تشير هذه الإشارات إلى عنوان عالي الجودة.
أمثلة على الحالات الحدّية: قبول
تغطّي الأمثلة التالية الحالات التي يشير فيها الرمز verdict
إلى مشاكل في جودة العنوان تستدعي إجراء المزيد من التحقيق. توضّح هذه الأمثلة أيضًا كيف يمكن أن تنتقل منطقك من الحكم إلى مكوّنات العنوان للحصول على صورة أكثر اكتمالاً من أجل تحسين منطق نظامك.
رقم شارع غير مؤكَّد خارج الولايات المتحدة
يوضّح هذا المثال إدخال عنوان إيطالي يتضمّن جميع مكوّنات العنوان
بدون أي مكوّنات مستنتَجة أو مستبدَلة. ومع ذلك، فإنّ
validationGranularity
هو ROUTE
.
تم إدخال العنوان | المنطقة |
---|---|
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia | إيطاليا |
نتيجة رقم شارع لم يتم تأكيده
{
"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 | الولايات المتحدة |
بيانات هيئة البريد الأمريكية لرقم شارع غير مؤكَّد
{
"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 Beach Gardens, FL 33418-1703 | الولايات المتحدة |
حالة عنوان مؤكَّد يتضمّن بيانات غير مكتملة من خدمة البريد الأمريكية
{
"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"
}