التعامل مع العناوين في الولايات المتحدة

يتناول هذا المستند عملية التحقّق من العنوان في الولايات المتحدة:

• استخدام بيانات USPS في سير العمل
• حقول التحقّق من نقطة التسليم في USPS‏ (dpv)
• رسائل الأمان

بيانات USPS في سير العمل

عند التحقّق من صحة العناوين في الولايات المتحدة، يمكن لواجهة Address Validation API أيضًا ملء جزء uspsData من الردّ.

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

التحقّق من نقطة التسليم (DPV) في خدمة البريد في الولايات المتحدة (USPS)

كجزء من استجابة uspsData، يعرض الحقل dpvConfirmation حرفًا واحدًا لإعلامك بما إذا كان بإمكان USPS التسليم إلى العنوان المقدَّم.

يمكنك استخدام هذا الحقل لتحديد ما يلي:

• صلاحية العنوان.
• إذا كان رقم المبنى الفرعي غير متوفّر في العنوان
• إذا لم يكن رقم المبنى الفرعي متوفّرًا في نظام بيانات USPS

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

يتناول بقية هذا القسم سيناريوهات واقعية تستخدم رموز DPV.

مثال على DPV N - تصحيح العنوان

يستخدم هذا المثال رقم شارع غير موجود في عنوان صالح.

• العنوان الذي تم إدخاله: 12 Amphitheatre Parkway, Mountain View, CA, 94043
• المنطقة: الولايات المتحدة الأمريكية
• يعرض الحقل dpvConfirmation ما يلي: N

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

مثال على DPV D - تصحيح العنوان

يستخدم هذا المثال مكتب Google في نيويورك، ولكنه لا يحتوي على مبنى فرعي وهو جزء مطلوب من العنوان. يمكنك الاطّلاع على ذلك باستخدام العنوان في الإصدار التجريبي بدون معلومات المبنى الفرعي.

• العنوان الذي تم إدخاله: 111 8th Avenue, New York, NY, 10011
• المنطقة: الولايات المتحدة الأمريكية
• يعرض الحقل dpvConfirmation ما يلي: D

يؤكّد ذلك أنّ المبنى الفرعي لم يكن مضمّنًا في الإدخال. للحصول على قيمة DPV تساوي Y، يجب تضمين مبنى فرعي صالح كجزء من الإدخال. على سبيل المثال، يمكنك تضمين مبنى فرعي صالح من FL 4 (الطابق الرابع) للحصول على قيمة dpvConfirmation لـ Y.

مثال على DPV S - تأكيد العنوان

يستخدم هذا المثال رقم مبنى فرعي غير موجود داخل المبنى:

• العنوان الذي تم إدخاله: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
• المنطقة: الولايات المتحدة الأمريكية
• يعرض الحقل dpvConfirmation ما يلي: S

يشير ذلك إلى أنّه على الرغم من أنّ العنوان 1600 Amphitheatre Parkway هو عنوان يمكنه تلقّي البريد، فإنّ المبنى الفرعي Ste 101 ليس جزءًا صالحًا من العنوان. يجب أن يؤكد نظامك هذه المعلومات مع المستخدم ويوفر فرصة للتصحيح.

مثال على DPV Y - قبول العنوان

يستخدم هذا المثال عنوان Googleplex في ماونتن فيو، كاليفورنيا كعنوان جودة معروف.

• العنوان الذي تم إدخاله: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
• المنطقة: الولايات المتحدة الأمريكية
• يعرض الحقل dpvConfirmation ما يلي: Y

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

ملاحظة: لا يشير DPV إلى ما إذا كانت Address Validation API قد أجرت أي تغييرات على الإدخال، مثل تصحيح إملائي.

رسائل الأمان للعناوين في الولايات المتحدة

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

عندما تحدّد خدمة USPS عنوانًا تم إنشاؤه بشكل اصطناعي، يحتوي الحقل errorMessage في السمة uspsData في الردّ على رسالة خطأ تصف المشكلة. على سبيل المثال:

AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.