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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

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

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

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

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