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

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

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

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

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

التحقّق من نقطة التسليم في USPS (DPV)

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

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

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

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

القيمة

السلوك

الوصف

لا

أو فارغ

تصحيح العنوان

لم يتم تأكيد العنوان من خلال DPV.

وهذا يعني أنّ USPS لا تتعرّف على رقم المبنى الذي تم إدخاله في الشارع (الطريق) الذي تم إدخاله، ولا يمكنها التسليم إلى هذا العنوان.

D

تصحيح العنوان

تم تأكيد العنوان من خلال DPV للرقم الأساسي فقط، ولم تكن معلومات الرقم الثانوي متوفّرة.

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

S

تأكيد العنوان

تم تأكيد العنوان من خلال DPV للرقم الأساسي فقط، وكانت معلومات الرقم الثانوي متوفّرة ولكن لم يتم تأكيدها.

وهذا يعني أنّ رقم المبنى الذي تم إدخاله متوفّر في الطريق الذي تم إدخاله، ولكن المبنى الفرعي المقدَّم غير متوفّر في هذا المبنى، وفقًا لـ USPS.

نعم

قبول العنوان

تم تأكيد العنوان من خلال DPV للأرقام الأساسية وأي أرقام ثانوية.

وهذا يعني أنّ USPS يمكنها تسليم العنوان بالكامل، بما في ذلك الـ رقم المبنى الفرعي، إن توفَّر.

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

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

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

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

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

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

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

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

يؤكّد هذا أنّ المبنى الفرعي لم يتم إدخاله. للحصول على قيمة Y في DPV، يجب تضمين مبنى فرعي صالح كجزء من الإدخال. على سبيل المثال، يمكنك تضمين مبنى فرعي صالح 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 في Mountain View، كاليفورنيا، كعنوان معروف بجودته.

  • العنوان الذي تم إدخاله: 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.