إضافة مبنى فرعي إلى العنوان - أمثلة (الولايات المتحدة فقط)

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

مثال شائع: إضافة مبانٍ فرعية

يوضح هذا السيناريو عنوانًا قد يطالب فيه نظامك العميل بإضافة رقم وحدة إلى العنوان.

العنوان الذي تم إدخاله المنطقة
‎1450 Brickell Avenue, Miami, FL 33131-4065 الولايات المتحدة

القرار بشأن عنوان لا يتضمّن مبنى فرعيًا

يُبرز المثال أدناه الإشارة المهمة.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

مثال على حالة حدّية: إضافة مبانٍ فرعية

يتناول المثال التالي حالة تشير فيها verdict إلى مشاكل في جودة العناوين تستدعي إجراء مزيد من التحقيق. يوضّح هذا المثال أيضًا كيف يمكن أن ينتقل المنطق من القرار إلى مكوّنات العنوان للحصول على صورة أكثر اكتمالاً من أجل تحسين منطق النظام.

المكوّنات الفرعية المفقودة والمستنتَجة والمستبدَلة

يوضّح هذا المثال إدخال عنوان في الولايات المتحدة مع عدم توفّر منطقة ورمز بريدي غير صحيح.

العنوان الذي تم إدخاله المنطقة
1450 Brickell Avenue, FL 33132-4065 الولايات المتحدة

Verdict for a missing subpremises and inferred and replaced components

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "hasReplacedComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

يكشف التحقيق الإضافي في مكوّنات العنوان أنّه تم استنتاج المنطقة واستبدال الرمز البريدي.

{
   "componentName": {
     "text": "33131",
   }
   "componentType": "postal_code",
   "confirmationLevel": "CONFIRMED",
   "replaced": true
},
{
   "componentName": {
     "text": "Miami",
     "languageCode": "en"
   }
   "componentType": "locality",
   "confirmationLevel": "CONFIRMED",
   "inferred": true
}