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

المطوّرون في المنطقة الاقتصادية الأوروبية

لماذا يجب استخدام خدمة Address Validation في Maps JavaScript API؟

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

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

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

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

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

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

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

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

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

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

طريقة عمل خدمة "التحقّق من صحة العنوان" في Maps JavaScript API

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

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

لمحة عن CASS™‎

تتولّى هيئة البريد الأمريكية (USPS®)1 إدارة نظام دعم دقة الترميز (CASS™) لتقديم الدعم لمقدّمي خدمات التحقّق من صحة العناوين واعتمادهم. تم تأكيد أنّ خدمة CASS Certified™‎، مثل Address Validation API، لديها القدرة على ملء المعلومات الناقصة في العنوان وتوحيد تنسيقه وتعديله لتقديم العنوان الأحدث والأكثر دقة.

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

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

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

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