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

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

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

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

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

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

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

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

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

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

القيمة

السلوك

الوصف

N أو فارغ

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

لم يتم تأكيد العنوان من خلال عملية إثبات الملكية والإقامة.

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

D

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

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

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

S

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

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

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

نعم

قبول العنوان

تم تأكيد عنوان 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

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