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

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

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

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

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

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

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

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

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

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

القيمة

السلوك

الوصف

N أو فارغ

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

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

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

D

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

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

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

S

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

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

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

نعم

قبول العنوان

تم تأكيد العنوان 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 في Mountain View, CA عنوان جودة معروف.

  • العنوان الذي تم إدخاله: 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.