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

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

حكم بشأن الأماكن الفرعية غير المتوفّرة والمكوّنات المستنتَجة والمستبدَلة

{
  "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
}