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

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

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

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

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

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

كجزء من الردّ 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

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

ملاحظة: لا يشير 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.