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

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

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

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

العنوان الذي أدخلته المنطقة
76 Buckingham Palace Road, London SW1W 9TQ المملكة المتحدة

بيان العنوان المقبول

يُبرز المثال التالي الإشارات المهمة.

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

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

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

بيانات 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 Beach 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"
}