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

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