أسباب استخدام واجهة برمجة تطبيقات التحقّق من صحة العناوين
من خلال واجهة برمجة تطبيقات التحقّق من صحة العناوين، يمكنك تحسين إمكانية توقُّع التسليم وتقليل حالات تعذُّر التسليم، وبالتالي تحسين تجربة العملاء. يمكنك القيام بذلك عن طريق اكتشاف العناوين السيئة والحصول على وعي أفضل بخصائص العنوان.
قد تكون واجهة برمجة التطبيقات Geocoding API مطابقة لاحتياجاتك بشكل أفضل إذا لم تكن بحاجة إلى التحقّق من صحة مكونات العنوان الفردي. تعمل واجهة برمجة تطبيقات الترميز الجغرافي على تحويل العناوين إلى إحداثيات خطوط العرض/الطول، في حين تتحقق واجهة برمجة التطبيقات "التحقّق من صحة العنوان" من صحة العناوين. يمكنك الاطّلاع على بناء إمكانية التحقق من الموقع الجغرافي باستخدام "منصة خرائط Google" في "مركز البنية" للحصول على مقارنة مفصّلة.
الإجراءات التي يمكنك اتّخاذها باستخدام واجهة برمجة التطبيقات التحقّق من صحة العناوين
باستخدام واجهة برمجة تطبيقات التحقّق من صحة العناوين، يمكنك تحديد ما إذا كان العنوان يشير إلى مكان حقيقي. إذا كان العنوان لا يشير إلى مكان حقيقي، يمكن لواجهة برمجة التطبيقات تحديد المكونات التي قد تكون خاطئة والتي يمكنك تقديمها إلى عملائك لتصحيحها. في ما يلي نموذج لسير العمل باستخدام واجهة برمجة التطبيقات:
يُدخل العميل عنوانًا: تعرض الصورة التالية نموذجًا بسيطًا يسمح للعميل بإدخال عنوان، ويمكن أن يكون جزءًا من مسار الدفع.
يرسل التطبيق العنوان إلى واجهة برمجة التطبيقات: يمرّر التطبيق هذا العنوان كإدخال في واجهة برمجة تطبيقات التحقّق من صحة العنوان.
تتحقق واجهة برمجة التطبيقات من العنوان وتوحيده: في ردّها، تعرض واجهة برمجة التطبيقات التحقّق من صحة العنوان العنوان الكامل الذي تحدّده واجهة برمجة التطبيقات أو تشير إلى الأماكن التي تكون فيها المعلومات غير متوفّرة.
تصحيح العنوان المقترَح أو تأكيده: استنادًا إلى المعلومات التي تعرضها واجهة برمجة التطبيقات، يمكنك تقديم الطلبات التالية للعميل:
تقديم عنوان مقترَح للعميل لتأكيده:
الطلب من العميل إضافة المعلومات الناقصة:
اطلب من المستخدم تصحيح العنوان في حال تعذّر على واجهة برمجة التطبيقات التحقّق من صحة عنوان الإدخال بسبب معلومات غير صحيحة أو غير متوفرة:
طريقة عمل واجهة برمجة تطبيقات التحقّق من صحة العناوين
تقبل عملية التحقق من العنوان طلب POST مع عنوان على شكل نص JSON. فهو يفصل العنوان إلى مكوناته الفردية، ثم يقوم بإجراء عمليات التحقق والتصحيحات التالية:
- صحيح: يقدم عمليات تحقّق على مستوى المكوِّن، بما في ذلك المباني الفرعية حيثما كان ذلك متاحًا.
- مكتمل: محاولات استنتاج مكوّنات العنوان المفقودة أو غير الصحيحة.
- تنسيق جيد: يؤدي إلى تنظيف تنسيق مكوّنات العنوان وتوحيده.
جرِّب الإصدار التجريبي للاطّلاع على واجهة برمجة تطبيقات التحقّق من صحة العناوين عمليًا.
المراجِع
يلخص الجدول التالي الموارد المتاحة من خلال واجهة برمجة تطبيقات التحقق من صحة العناوين مع البيانات التي تعرضها. للحصول على تفاصيل محددة، يُرجى الاطّلاع على مرجع واجهة برمجة تطبيقات التحقّق من صحة العناوين.
| موارد البيانات | تم إرجاع البيانات. |
|---|---|
|
مكوّنات العنوان بتنسيق JSON: يُرجى الاطّلاع على التحقّق من صحة عنوان. |
عنوان كامل تم التحقق من صحته (إن أمكن). حالة التحقّق من كل مكوّن عنوان الأماكن المتاحة لعنوان:
راجِع فهم ردّ التحقق من الصحة. |
كيفية استخدام واجهة برمجة تطبيقات التحقّق من صحة العناوين
| 1 | تجربة العرض التوضيحي | استكشِف العرض التوضيحي الذي يتضمّن مجموعة متنوعة من نماذج العناوين، سواء كانت صحيحة أم غير صحيحة. يوفّر العرض التوضيحي طريقة مفيدة لاستكشاف القيم المعروضة من الخدمة واستجابة واجهة برمجة التطبيقات بتنسيق JSON. |
| 2 | الاطّلاع على التغطية | يمكنك مراجعة تفاصيل التغطية للاطّلاع على البلدان والمناطق التي تتوفر فيها واجهة برمجة التطبيقات Address Verification API. |
| 3 | بدء الإعداد | ابدأ بعنوان إعداد مشروعك على Google Cloud وأكمِل التعليمات الواردة أدناه. |
| 4 | طلب التحقّق من العنوان | يمكنك البدء بعنوان بسيط، ثم تفعيل CASS (لعناوين الولايات المتحدة والعلاقات العامة فقط) للحصول على مزيد من الدقة. راجِع طلب التحقّق من العنوان. |
| 5 | معالجة ردّ | توفِّر استجابة "واجهة برمجة التطبيقات للتحقّق من صحة العنوان" سمتَين، تستخدم كل منهما بطرق مختلفة. يمكنك الاطّلاع على قسم فهم ردّ أساسي. |
| 6 | تحسين دقة التحقّق من الصحة | يمكنك المساعدة في تحسين دقة العنوان من خلال تقديم ملاحظات حول ردود واجهة برمجة التطبيقات التحقّق من صحة العناوين. يُرجى الاطّلاع على التعامل مع العناوين المعدّلة. |
مكتبات العملاء المتاحة
للحصول على قائمة بمكتبات العملاء المتاحة لواجهة برمجة تطبيقات التحقّق من صحة العناوين، راجِع مكتبات العملاء.
معلومات عن CASSTM
تحتفظ خدمة ®Mail Postal Service (®USPS®) التابعة للولايات المتحدة 1 بـ نظام دعم دقة الترميز (CASSTM) لدعم مقدّمي خدمات التحقُّق من العناوين واعتمادهم. تم التأكّد من إحدى خدمات TMCASS المعتمدة، مثل واجهة برمجة تطبيقات التحقّق من صحة العناوين، لأنّها تستطيع ملء المعلومات غير المتوفّرة من أحد العناوين وتوحيدها وتحديثها بما يتيح لك توفير العناوين الأحدث والأكثر دقة.
لا يتم تفعيل CASS تلقائيًا ويكون متوافقًا فقط مع منطقتَي "الولايات المتحدة" و "PR". لتفعيل CASS، عليك ضبط السمة enableUspsCass على true كجزء من طلب التحقّق. لمزيد من المعلومات، راجِع التحقّق من صحة العنوان.
في إطار استخدامنا لخدمات USPS، تقيّم هذه الخدمة طلبات العناوين التي تم إنشاؤها بشكل مصطنع. في حال رصدت USPS عنوانًا تم إنشاؤه بشكل مصطنع، على Google إيقاف التحقّق من صحة العناوين الخاصة بالعميل، والإبلاغ عن معلومات الاتصال الخاصة بالعميل (الاسم والعنوان) وعنوان الإدخال ذي الصلة وبيانات الاستخدام المجمَّعة إلى USPS. يعني استخدامك لواجهة برمجة التطبيقات أنك توافق على هذه البنود الخاصة بالخدمات.
الخطوات التالية
- مراجعة الأسئلة الشائعة: الانتقال إلى الأسئلة الشائعة
- مراجعة مناطق التغطية: يمكنك الانتقال إلى تفاصيل التغطية الخاصة بالبلدان والمناطق.
- معالجة العناوين بكميات كبيرة: انتقِل إلى استخدام واجهة برمجة تطبيقات التحقّق من صحة العناوين لمعالجة العناوين بأعداد كبيرة.
-
"منصة خرائط Google" هي "منصة خرائط Google" جهة مرخَّص لها غير حصرية في الولايات المتحدة. وترتبط العلامات التجارية التالية بخدمة ®Postal Service بالولايات المتحدة، ويتم استخدامها بموجب إذن: ®Postal Service وCASSTM وCASS CertificateTM. ↩