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

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

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

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

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

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

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

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

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

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

القيمة

السلوك

الوصف

N أو فارغ

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

لم يتم تأكيد DPV للعنوان.

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

D

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

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

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

S

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

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

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

Y

قبول العنوان

تم تأكيد العنوان 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 (4th Floor) للحصول على قيمة 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 إلى ما إذا كانت واجهة برمجة تطبيقات التحقق من صحة العنوان قد أجرت أي تغييرات على الإدخال، مثل التصحيح الإملائي.

رسائل الأمان لعناوين الولايات المتحدة

يتناول هذا القسم علامات الأمان المقدّمة في بيانات 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.