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

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

ما هي مزايا استخدام 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، تحاول واجهة برمجة التطبيقات تنفيذ ما يلي:

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

لمحة عن CASS™

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

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

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

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

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