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

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

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

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

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

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

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

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

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

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

القيمة

السلوك

الوصف

لا

أو فارغ

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

لم يتم تأكيد العنوان من خلال ميزة "التحقّق من نقطة التسليم".

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

D

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

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

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

S

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

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

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

نعم

قبول العنوان

تم تأكيد العنوان من خلال ميزة "التحقّق من نقطة التسليم" للأرقام الأساسية وأي أرقام ثانوية.

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

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

مثال على رمز "التحقّق من نقطة التسليم" N - تصحيح العنوان

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

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

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

مثال على رمز "التحقّق من نقطة التسليم" D - تصحيح العنوان

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

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

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

مثال على رمز "التحقّق من نقطة التسليم" S - تأكيد العنوان

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

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

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

مثال على رمز "التحقّق من نقطة التسليم" Y - قبول العنوان

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

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

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

ملاحظة: لا يشير رمز "التحقّق من نقطة التسليم" إلى ما إذا كانت واجهة برمجة التطبيقات 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.