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

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

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

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

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

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

كجزء من ردّ 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 شارع السلام، القاهرة، 10011
  • المنطقة: الولايات المتحدة الأمريكية
  • يعرض الحقل dpvConfirmation ما يلي: D

وهذا يؤكد أن المبنى الفرعي كان غير موجود في الإدخال. للحصول على DPV من Y، ينبغي تضمين فرضية فرعية صالحة كجزء من الإدخال. على سبيل المثال، يمكنك تضمين مبنى فرعي صالح للمبنى FL 4 (الطابق الرابع) للحصول على القيمة "ص" للسمة dpvConfirmation.

مثال على DPV S - تأكيد العنوان

يستخدم هذا المثال رقم مبنى فرعي غير موجود داخل المبنى:

  • العنوان الذي تم إدخاله: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • المنطقة: الولايات المتحدة الأمريكية
  • يعرض الحقل dpvConfirmation ما يلي: S

يشير هذا إلى أنه على الرغم من وجود 1600 Amphitheatre Parkway كعنوان يمكنه قبول البريد، فإن المبنى الفرعي Ste101 ليس جزءًا صالحًا من العنوان. ويجب أن يؤكّد نظامك هذه المعلومات مع المستخدم وأن يوفّر فرصة للتصحيح.

مثال على 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.