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

يوضِّح هذا المستند عددًا من السيناريوهات الواقعية التي توفِّر فيها واجهة برمجة تطبيقات التحقّق من صحة العناوين إشارات استجابة تستحق إجراء قبول من نظامك. راجِع نظرة عامة على سير العمل في قسم استخدام ردّ التحقق من الصحة للتعرُّف على السياق.

مثال شائع: قبول

يوضح هذا السيناريو عنوانًا يقبل نظامك فيه العنوان الذي أدخله العميل.

تم إدخال العنوان. منطقة
76 Buckingham Palace Road, London SW1W 9TQ المملكة المتحدة

بيان صحة عنوان مقبول

يوضح المثال التالي الإشارات المهمة.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

بالإضافة إلى ذلك، يوضح الرد ما يلي:

  • يبقى hasUnconfirmedComponents false.
  • يبقى hasInferredComponents false.
  • يبقى hasReplacedComponents false.

وعند الجمع بين هذه الإشارات، فإنها تشير إلى عنوان عالي الجودة.

أمثلة على الحالة الحدّية: قبول

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

رقم شارع غير مؤكّد في الولايات المتحدة

يوضح هذا المثال إدخال عنوان إيطالي مع جميع مكونات العنوان الحالية، دون أي عناصر يمكن استنتاجها أو استبدالها. في المقابل، قيمة السمة validationGranularity هي ROUTE.

تم إدخال العنوان. منطقة
شارع فونت غرونيل، 14 وحدة 2، 66054 فاستو CH، إيطاليا إيطاليا

بيان بشأن رقم شارع لم يتم تأكيده

{
  "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 الولايات المتحدة

بيانات USPS لرقم شارع غير مؤكد

{
   "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 بيتش Gardens, FL 33418-1703 الولايات المتحدة

قرار بشأن عنوان تم تأكيده مع بيانات USPS غير مكتملة

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