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

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

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