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

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

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

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

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

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

ويسلط المثال التالي الضوء على الإشارات المهمة.

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

بالإضافة إلى ذلك، تشير الاستجابة إلى ما يلي:

  • سيبقى hasUnconfirmedComponents false
  • سيبقى hasInferredComponents false
  • سيبقى hasReplacedComponents false

تشير هذه الإشارات عند دمجها معًا إلى عنوان عالي الجودة.

أمثلة على الحالة الحدّية: قبول

تتناول الأمثلة التالية الحالات التي تشير فيها verdict إلى العنوان. أو مشكلات الجودة التي تتطلب مزيدًا من التحقيق. توضح هذه الأمثلة أيضًا توضيح كيف يمكن لمنطقك الانتقال من البيان إلى مكونات العنوان للحصول على صورة أكثر اكتمالاً لتعزيز منطق النظام.

رقم الشارع غير مؤكَّد في الولايات المتحدة

يوضّح هذا المثال إدخال عنوان إيطالي بجميع مكوّنات العنوان. حاليًا، مع عدم وجود أي مكونات استنتاجية أو مستبدلة. ومع ذلك، تم ROUTE ميزة validationGranularity.

تم إدخال العنوان المنطقة
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"
}

لم يتم تأكيد رقم الشارع في الولايات المتحدة.

يوضّح هذا المثال إدخال عنوان في الولايات المتحدة الأمريكية يتضمّن جميع عناصر العنوان. دون وجود أي مكونات استنتاجية أو مستبدلة. ومع ذلك، تم PREMISE_PROXIMITY ميزة validationGranularity.

تم إدخال العنوان المنطقة
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 Park Garden, 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"
}