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

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

بيانات هيئة البريد الأمريكية لرقم شارع غير مؤكَّد

{
   "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) لعنوان تم تأكيده

يوضّح هذا المثال إدخال عنوان في الولايات المتحدة مع تأكيد جميع مكوّنات العنوان، بدون أي مكوّنات مستنتَجة أو مستبدَلة، وبدقة PREMISE.validationGranularity ومع ذلك، لم تتم تعبئة 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"
}