قبول العنوان - أمثلة

تصف هذه المقالة عددًا من السيناريوهات الواقعية التي توفّر فيها Address Validation API إشارات استجابة تبرّر سلوك قبول من نظامك. للحصول على السياق، اطّلِع على نظرة عامة على سير العمل في استخدام استجابة التحقّق من الصحة.

مثال شائع: قبول

يوضّح هذا السيناريو عنوانًا سيقبله نظامك إذا أدخله أحد العملاء.

العنوان الذي تم إدخاله المنطقة
‎76 Buckingham Palace Road, London SW1W 9TQ المملكة المتحدة

النتيجة لعنوان مقبول

يوضّح المثال أدناه الإشارات المهمة.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

بالإضافة إلى ذلك، تشير verdict إلى ما يلي:

  • hasUnconfirmedComponents تظل false
  • hasInferredComponents تظل false
  • hasReplacedComponents تظل 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 الولايات المتحدة

بيانات 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 Beach Gardens, 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"
}