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

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