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

يوضّح هذا المستند عددًا من السيناريوهات الواقعية التي تقدّم فيها واجهة 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"
}