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

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

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

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

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

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

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

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

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

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

القيمة

السلوك

الوصف

لا

أو فارغ

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

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

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

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 (الطابق الرابع) للحصول على قيمة 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.