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

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