يتناول هذا المستند عملية التحقق من صحة العنوان الخاص بالولايات المتحدة:
بيانات 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.