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

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

بيانات 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 (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.