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

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

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

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

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

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

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

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

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

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

القيمة

السلوك

الوصف

N أو فارغ

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

لم يتم تأكيد العنوان باستخدام نظام 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 هو عنوان صالح، إلا أنّ المكان الفرعي Suite 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.