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

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

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

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

نتيجة عنوان مؤكَّد يتضمّن بيانات غير مكتملة من خدمة البريد الأمريكية

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