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

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

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

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

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

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

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

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

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

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

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

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

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

طريقة عمل Address Validation في Maps JavaScript API

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

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

لمحة عن CASS™‎

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

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

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

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

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