نظرة عامة على ميزة "التحقّق من العنوان"

لماذا يجب استخدام ميزة "التحقّق من العنوان" في واجهة برمجة التطبيقات Maps JavaScript API؟

تأخذ مكتبة التحقّق من العناوين عنوانًا كمدخل لتحديد مكونات العنوان والتحقّق منها. وتُوحد هذه الخدمة أيضًا العنوان البريدي وتبحث عن أفضل إحداثيات خطوط العرض/الطول المعروفة له. يمكنك اختياريًا تفعيل CASS™ (نظام دعم دقة الترميز) للعناوين في الولايات المتحدة و بورتوريكو.

باستخدام Address Validation API، يمكنك تحسين توقّعات التسليم والحدّ من حالات تعذُّر التسليم، ما يؤدي إلى تقديم تجربة محسّنة للعملاء. يمكنك إجراء ذلك من خلال رصد العناوين غير الصالحة والتعرّف بشكل أفضل على خصائص العناوين.

الإجراءات التي يمكنك تنفيذها باستخدام واجهة برمجة التطبيقات Address Validation في Maps JavaScript API

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

  1. إدخال العميل لعنوان: تعرض الصورة التالية نموذجًا أساسيًا يتيح للعميل إدخال عنوان، ربما كجزء من عملية الدفع.

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

  2. يرسل التطبيق العنوان إلى واجهة برمجة التطبيقات: يُرسِل التطبيق هذا العنوان باستخدام الطريقة fetchAddressValidation.

  3. تحقّق واجهة برمجة التطبيقات من العنوان وتُعَدّله: في ردّها، تعرِض Address Validation API العنوان الكامل كما تحدّده واجهة برمجة التطبيقات، أو تشير إلى المواضع التي لا تتوفّر فيها معلومات.

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

    1. أكِّد العنوان المقترَح.
    2. قدِّم المعلومات غير المتوفّرة.
    3. تصحيح العنوان
    يمكن للعميل تأكيد العنوان الذي تم تصحيحه. يمكن للعميل تقديم المعلومات غير المتوفّرة. يمكن للعميل تصحيح العنوان.

آلية عمل ميزة "التحقّق من العنوان" في Maps JavaScript API

عند إجراء طلب بيانات من fetchAddressValidation، تحاول واجهة برمجة التطبيقات إجراء ما يلي:

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

لمحة عن CASS™

تدير شركة United States Postal Service® (USPS®)1 نظام دعم دقة الترميز (CASS™) لمساعدة مقدّمي خدمات التحقّق من العناوين واعتمادهم. تم تأكيد خدمة CASS Certified™، مثل Address Validation API، على قدرتها على ملء المعلومات غير المتوفّرة في العنوان وتوحيدها وتعديلها لمنحك أحدث وأدق عنوان.

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

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

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

  1. "منصّة خرائط Google" هي مرخّص غير حصري لخدمة البريد الأمريكي Postal Service®. تملك خدمة البريد الأمريكي Postal Service® العلامات التجارية التالية ويتم استخدامها بإذن: United States Postal Service®، CASS™، CASS Certified™. ↩