فحص العنوان في تطبيقك: هل يحل التصحيح المقترح محل ما كتبه العميل؟

تعامل مع خدمة فحص العناوين كمصدر معلومات لاتخاذ قرار، لا كإذن لتغيير وجهة العميل بصمت. حدد النتائج المقبولة، والنتائج التي تحتاج إلى تأكيد، والحالات التي تتطلب تفصيلا ناقصا أو مراجعة موظف. تنسيق عنوان بصورة أنيقة لا يثبت أن العميل قصد ذلك المبنى.

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

افحص النتيجة بدلا من إظهار علامة نجاح عامة

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

حدد نتائج قليلة يفهمها المستخدم: المتابعة بالعنوان المفحوص، أو مقارنة اقتراح، أو طلب تفصيل ناقص، أو حفظ الحالة للمراجعة. هذه حالات مقترحة لتطبيقك، لا تطابق مضمون مع حقول المزود حالة بحالة.

اطلب من المطور شرح الربط باستخدام حالات موثقة للاستجابة. لا تقبل قاعدة تعتبر كل استجابة HTTP ناجحة دليلا على صحة الوجهة. قد تستجيب الخدمة بنجاح تقني وهي تبلغ عن مشكلة في العنوان.

اعرض التغييرات المهمة قبل تأثيرها في الطلب

توضح Google أن العنوان المعالج قد يتضمن أجزاء ذات أخطاء إملائية وأجزاء استُبدلت أو استُنتجت لإكمال النقص. ينبغي أن يفهم المستخدم أي تغيير جوهري قبل أن يؤثر في العمل أو الطلب.

في مثال مختلق لخدمة زيارات منزلية، تصحيح كتابة اسم شارع يختلف عن اقتراح رقم مبنى آخر. اعرض النسخة المدخلة والمقترحة بتسميتين واضحتين، واجعل الاختلاف مفهوما دون الاعتماد على اللون وحده. تجنب موافقة محددة مسبقا قد تدفع العميل إلى اعتماد وجهة غير مألوفة دون قصد.

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

اكتمال العنوان ودقة موضعه على الخريطة أمران مختلفان

تعرف Google خاصية addressComplete بأنها تشير إلى غياب الأجزاء الناقصة أو غير المحسومة أو غير المتوقعة. وتحذر من أن عدم ظهور الخاصية يعني أن قيمتها false. لذلك لا يجوز للتكامل تفسير غياب الحقل على أنه نتيجة إيجابية لمجرد عدم ظهور رسالة تحذير.

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

احتفظ بتعليمات الزيارة منفصلة عن العنوان البريدي عند الحاجة. وصف البوابة أو جهة اتصال عند الوصول قد يفيد الفريق، لكنه لا ينبغي أن يحل محل رقم الوحدة. ولا تستنتج من نجاح الفحص أن الشخص يقيم هناك أو يملك العقار أو يستحق خدمة في ذلك الموقع.

افصل تعذر الفحص عن العنوان الذي يحتاج إلى تصحيح

حدد قاعدة العمل عند انتهاء مهلة الخدمة أو تعذر الاتصال بها. هل يمكن حفظ مسودة؟ هل تدخل الاستفسارات قائمة غير مفحوصة؟ هل يجب التواصل مع العميل قبل تأكيد الزيارة؟ توقف خدمة الفحص ليس النتيجة نفسها التي تطلب تعديل العنوان.

لا تصف عنوانا لم يُفحص بأنه مؤكد حتى يكتمل النموذج. وفي المقابل لا تمحُ ما كتبه العميل بسبب عطل الخدمة. سمّ المسؤول عن معالجة الحالات المعلقة واجعل قائمتها مرئية لمن يتعامل معها.

قبل اختيار المزود، راجع تغطية الدول الفعلية وشروط الخدمة ومعالجة البيانات وتكاليف الاستخدام. هذا المقال لا يثبت تغطية عالمية ولا يأذن بشراء خدمة ولا يضمن وصول زيارة أو شحنة.

اختبر القرارات عند الاستلام

استخدم حالات اختبار يدعمها المزود مع بيانات عملاء مختلقة. اعرض عنوانا مناسبا دون تغيير، واقتراح تعديل، ورقم وحدة أو جزء آخر ناقصا، ورفض الاقتراح، وتعذر الاتصال بالخدمة. افحص شاشة العميل والسجل الذي يصل إلى الموظف في كل مرة.

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

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