إنشاء منطق التحقّق

يصف هذا المستند عملية إنشاء نظام للتحقّق من العناوين من أجل التعامل مع مجموعة متنوعة من الردود من Address Validation API. ويتناول كيفية إنشاء المنطق لاستخدام الاستجابة بشكل صحيح، والتحقيق في الإشارات الأخرى من واجهة برمجة التطبيقات، ومتى وكيفية مطالبة عملائك بمزيد من المعلومات.

بشكل عام، يحدّد الردّ من واجهة برمجة التطبيقات الطرق التالية التي يجب أن يتعامل بها نظامك مع العنوان:

• handyman إصلاح: العنوان منخفض الجودة. يجب أن تطلب المزيد من المعلومات.
• edit تأكيد: العنوان عالي الجودة، ولكنّه يتضمّن تغييرات عن العنوان الذي تم إدخاله. قد يُطلب منك تأكيد الإجراء.
• check قبول: العنوان عالي الجودة. يمكنك قبول العنوان المقدَّم.

الغرض الرئيسي

يساعدك هذا المستند في تعديل نظامك لتحليل الردّ من واجهة برمجة التطبيقات بشكل أفضل وتحديد الإجراءات التالية التي يجب اتّخاذها بشأن العناوين المقدَّمة. يوضّح الرمز الزائف التالي عملية محتملة.

if (the API response indicates significant problems in the address)
    FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
    CONFIRM - confirm with the user that the address is correct
else
    ACCEPT - continue with the address returned by the API.

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

نظرة عامة على سير العمل

يلخّص الجدول أدناه إجراءَين لنظامك:

1. سير العمل الذي يجب استخدامه استنادًا إلى سلوك الإصلاح والتأكيد والقبول
2. أول الإشارات التي يجب التحقّق منها من الردّ إنّ الإشارات الموضّحة هنا مصدرها السمة verdict وليست الإشارات الوحيدة التي يجب التحقّق منها، ولكنّها توفّر مؤشرًا أوليًا على جودة العنوان. يتوافق كل نوع سلوك مع قسم في هذا المستند يصف الإشارات الإضافية التي قد تحتاج أيضًا إلى التحقيق فيها.

إرشادات التنفيذ

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

تصحيح عنوان

تصحيح عنوان عندما تشير النتائج بوضوح إلى أنّ العنوان غير قابل للتسليم يمكن لنظامك بعد ذلك أن يطلب من العميل تقديم المعلومات اللازمة، وبعد ذلك يمكنك إعادة إصدار سير العمل للحصول على عنوان قابل للتسليم.

حلّ المشاكل في الإشارات

توفّر واجهة Address Validation API عددًا من الإشارات لإعلامك بما إذا كان يجب إصلاح عنوان معيّن.

1. دقة التحقّق من الصحة والمكوّنات غير المتوفّرة

توفّر هاتان الإشارتان أفضل مؤشر على عنوان يمثّل مشكلة:

• عندما يكون الحقل validationGranularity هو OTHER، على نظامك التحقيق في إشارات مكوّنات العنوان لمعرفة المزيد حول مكان حدوث الخطأ وكيفية حلّه.
• عندما يعرض عنصر address الذي تمت معالجته لاحقًا حقل missingComponentTypes، على نظامك التحقّق من هذا المكوّن. وتؤدي المكوّنات الناقصة أيضًا إلى جعل العنوان غير مكتمل وغير قابل للتسليم.

2. الإشارات الأخرى

توفّر واجهة Address Validation API أيضًا إشارات أخرى للمساعدة في تشخيص مشاكل معيّنة:

3- إشارات العناوين في الولايات المتحدة

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

لمعرفة التفاصيل حول dpvConfirmation، يُرجى الاطّلاع على مقالة التعامل مع العناوين في الولايات المتحدة.

أمثلة على تصحيح العناوين

تأكيد عنوان

يمكنك تأكيد عنوان عندما يشير القرار إلى أنّ Address Validation API قد استنتجت أو أجرت تغييرات على مكوّنات العنوان لإنشاء عنوان تم التحقّق منه. في هذه الحالات، يكون لديك عنوان قابل للتسليم، ولكنّك تفضّل زيادة الثقة في أنّ العنوان الناتج هو العنوان الذي يقصده العميل.

لتزويد العميل بالطلب الصحيح، سيحدّد المنطق الخاص بك المكوّنات التي تم وضع علامة عليها من قِبل الخدمة لتحديد الإجراء أو العلامة التي طبّقتها واجهة برمجة التطبيقات على المكوّن، مثل inferred أو replaced أو spellCorrected. اطّلِع على AddressComponent في المرجع.

تأكيد الإشارات

توفّر واجهة Address Validation API عددًا من الإشارات لإعلامك بما إذا كان يجب تأكيد العنوان.

1. دقة التحقّق

يُعدّ استخدام validationGranularity من ROUTE أو أفضل مقبولاً، ولكنّ استخدام PREMISE أو SUBPREMISE يوفّر إشارة أقوى على إمكانية التسليم.

2. الإشارات الأخرى

عند اتخاذ قرار بتأكيد إدخال العنوان مع العميل، يوفّر الحكم أيضًا ما يلي لتحديد المكوّنات التي يجب التحقيق فيها:

3- إشارات العناوين في الولايات المتحدة

تشير بعض الحقول التي تنطبق فقط على العناوين في الولايات المتحدة إلى أن منطقك يجب أن يؤكد التفاصيل مع العميل. ينطبق أيّ مما يلي:

أمثلة على تأكيد العنوان

قبول عنوان

يمكنك قبول عنوان عندما يوفّر القرار درجة عالية من الثقة بأنّ العنوان قابل للتسليم ويمكن استخدامه بدون أي تفاعل إضافي من العميل في العملية اللاحقة.

قبول الإشارات

توفّر واجهة Address Validation API عددًا من الإشارات لإعلامك بما إذا كان يجب تأكيد العنوان.

1. دقة التحقّق

يُعدّ validationGranularity من PREMISE أو أفضل مقبولاً، ولكن في بعض الحالات، لا يزال ROUTE يشير إلى عنوان قابل للتسليم.

2. الإشارات الأخرى

يجب أن يوفّر القرار بشأن عنوان عالي الجودة ما يلي أيضًا:

• عدم استبدال البيانات: في هذه الحالة، hasReplacedComponents: FALSE.
• ما مِن مكوّنات مستنتَجة. في هذه الحالة، hasInferredComponents: FALSE.

3- إشارات العناوين في الولايات المتحدة

تشير بعض الحقول التي تنطبق فقط على العناوين في الولايات المتحدة إلى عنوان عالي الجودة يمكن التسليم إليه. بالنسبة إلى العنوان المقبول في الولايات المتحدة، من المفترض أن يظهر لك ما يلي:

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