نظرة عامة على واجهة برمجة التطبيقات للتحقق من العنوان

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

توفر واجهة برمجة تطبيقات التحقق من العنوان العديد من الميزات لمساعدتك في معالجة العنوان، بما في ذلك:

  • يفصل العنوان إلى المكونات الفردية ومن ثم يقدم عمليات تحقق على مستوى المكونات، بما في ذلك الوحدات التنظيمية الفرعية (حيثما يكون ذلك متاحًا).

  • تطهير وتوحيد واستنتاج مكونات العنوان المفقودة أو غير الصحيحة.

  • يُكمِّل العنوان بمعلومات إضافية، بما في ذلك الرمز الجغرافي، ودقة العنوان، وبيانات الخدمات البريدية.

  • لعرض سلسلة واحدة تحتوي على العنوان الكامل كما هو محدد في واجهة برمجة التطبيقات.

جرِّب الإصدار التجريبي لمشاهدة واجهة برمجة التطبيقات للتحقق من صحة العنوان عمليًا.

إضافة واجهة برمجة تطبيقات التحقق من العنوان إلى سير العمل

تتمثل إحدى حالات الاستخدام الأكثر شيوعًا لواجهة برمجة تطبيقات "التحقق من العنوان" في تحسين تجربة العميل عن طريق ضمان تقديم العميل لعنوان صحيح. يساعد التحقق من العنوان على الحد من إخفاقات التسليم من خلال اكتشاف العناوين السيئة وتحسين إمكانية توقع التسليم مع زيادة الوعي بخصائص العنوان.

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

العنوان كما أدخله العميل.

في الاستجابة، تعرض واجهة برمجة التطبيقات للتحقق من صحة العنوان العنوان الكامل على النحو الذي تحدده واجهة برمجة التطبيقات. قدم العنوان الكامل إلى عميلك باعتباره العنوان الموصى به:

العنوان كما هو محدد بواسطة واجهة برمجة التطبيقات.

إذا اكتشفت واجهة برمجة التطبيقات للتحقق من صحة العنوان بعض المعلومات المفقودة، فاطلب من المستخدم إضافتها:

النموذج الذي يطالب العميل بإدخال معلومات العنوان المفقودة.

إذا تعذّر على واجهة برمجة التطبيقات التحقّق من صحة عنوان الإدخال بسبب نقص المعلومات أو عدم صحتها، اطلب من المستخدم إصلاح العنوان:

النموذج الذي يطالب العميل بتصحيح معلومات العنوان.

الاختلافات بين واجهة برمجة التطبيقات للتحقق من العنوان وواجهة برمجة التطبيقات للترميز الجغرافي

يحاول كل من واجهة برمجة التطبيقات للترميز الجغرافي وواجهة برمجة التطبيقات للتحقق من العنوان الإجابة عن السؤال "ما هو أفضل موقع لإدخال المستخدم هذا؟" على عكس واجهة برمجة تطبيقات الترميز الجغرافي، تحاول أيضًا واجهة برمجة التطبيقات للتحقق من صحة العنوان تنفيذ ما يلي:

  • أجب عن سؤال "هل يمثل إدخال المستخدم هذا عنوانًا حقيقيًا؟"
  • فهم عنوان الإدخال حتى إذا تعذرت مطابقة أجزاء منه بالبيانات المتاحة
  • تقديم ملاحظات حول صلاحية المكونات المختلفة
  • تحقق مما إذا كان العنوان مكتملاً وأبلغ عن أي مكونات ضرورية مفقودة
  • تنسيق العنوان المعروض تحديدًا لأغراض إرسال البريد

فعلى سبيل المثال، بافتراض وجود عنوان مثل "123 Fake St, Mountain View, CA"، فإن واجهة برمجة تطبيقات الترميز الجغرافي ستعرض ببساطة رمزًا جغرافيًا لمدينة "ماونتن فيو" بولاية كاليفورنيا وتتجاهل "123 Fake St" نظرًا لعدم وجود مثل هذا الشارع (أو شارع يحمل الاسم نفسه) في "ماونتن فيو".

وعلى الجانب الآخر، يمكن لواجهة برمجة تطبيقات التحقق من العنوان التعرف على أن "123" هو رقم الشارع، وأن "Fake St" هو أحد الشوارع، وتعرض نتيجة تحتوي على هذه العناصر والعلامات كغير مؤكدة، مما يعطيك إشارة إلى سبب إخفاق العنوان في الترميز الجغرافي.

حول CASSTM

تحتفظ 1 التابعة لـ US Postal Service® (USPS®)بنظام دعم دقة الترميز (CASSTM) لدعم مقدمي خدمة التحقق من العنوان واعتمادهم. تم تأكيد خدمة TMCASS المعتمدة، مثل واجهة برمجة تطبيقات التحقق من العنوان، بسبب قدرتها على ملء المعلومات المفقودة من أحد العناوين، وتوحيدها، وتحديثها لمنحك العنوان الحالي الأكثر دقة.

لم يتم تمكين CASS افتراضيًا، ولا يتم دعمه إلا لمناطق "الولايات المتحدة" و "PR". لتفعيل CASS، يجب ضبط enableUspsCass على true كجزء من طلب التحقق. لمزيد من المعلومات، راجع التحقق من صحة العنوان.

كجزء من استخدامنا لخدمات USPS، تقيّم خدمة USPS طلبات الحصول على عناوين مصطنعة. إذا تبيّن لـ USPS عنوان إدخال تمّ إنشاؤه بطريقة مصطنعة، يتعيّن على Google التوقف عن التحقّق من صحة عناوين العملاء ويجب أن تبلغ الشركة عن معلومات الاتصال (الاسم والعنوان) وعنوان الإدخال ذي الصلة وبيانات الاستخدام المجمّعة. يعني استخدامك لواجهة برمجة التطبيقات موافقتك على البنود الخاصة بالخدمة.

الخطوات التالية


  1. نظام خرائط Google الأساسي هو المُرخّص له غير الحصري لـ خدمة البريد في الولايات المتحدة®. العلامات التجارية التالية مملوكة من قبل خدمة البريد في الولايات المتحدة ويتم استخدامها بإذن: TMالولايات المتحدة للخدمات البريدية، وTMCAS، وشهادة CASSTM.