الهدف
في هذا المستند، سنلقي نظرة على كيفية استخدام Address Validation API في جداول بيانات Google لاختبار الخدمة بطريقة سريعة وخفيفة.
إذا لم تكن من المطوّرين، ولكنك تريد العمل مع البيانات الواردة من منصّة "خرائط Google"، مثل واجهة برمجة التطبيقات لإثبات صحة العنوان، يمكنك البحث عن طريقة للبدء في استخدام الخدمة بدون مساعدة مكثفة من الفِرق التقنية.
حالات الاستخدام
دعنا نفهم الآن حالات الاستخدام التي تكون فيها واجهة Address Validation API مفيدة في "جداول بيانات Google":
- الإصدار التجريبي: بصفتك نشاطًا تجاريًا، يمكنك اختبار إمكانيات واجهة برمجة التطبيقات للتحقق من صحة العنوان بسرعة باستخدام عناوينك الخاصة.
- المقارنة: قارِن نتائج Address Validation API بنتائج نقاط النهاية الأخرى، مثل Geocoding API أو Places API.
- اختبار A/B: يمكنك إجراء اختبارات A/B من مجموعة البيانات نفسها لمعرفة ما قد يقدّم نتائج أكثر ملاءمة.
نموذج "جداول بيانات Google"
يتمثل الحل في جداول بيانات Google التي تأتي مزوّدة بدوال برمجة تطبيقات Google مخصّصة ستنفّذ الطلبات بالتسلسل إلى واجهة برمجة التطبيقات لإثبات صحة العنوان.
يمكنك تشغيل العناوين من خلال واجهة برمجة التطبيقات باتّباع الخطوات التالية (يتطلب ذلك امتلاك حساب Google ومفتاح واجهة برمجة التطبيقات):
- انتقل إلى نموذج
جدول بيانات
ومن القائمة حدد: ملف > إنشاء نسخة
(يجب تسجيل الدخول إلى حساب Google أو إنشاء نسخة) - فعِّل واجهة برمجة التطبيقات للتحقق من صحة العنوان
وأنشِئ مفتاح واجهة برمجة تطبيقات من Cloud Console.
- في علامة تبويب "جداول بيانات Google" ضمن "مفتاح واجهة برمجة التطبيقات + لوحة البيانات"، استبدِل خلية B2 بمفتاح واجهة برمجة التطبيقات.
- نسخ/لصق العناوين في النموذج (في ورقة منفصلة لتنسيق البيانات: ربط رقم الشارع والاسم والمدينة والرمز البريدي)
- اختَر خلايا "جداول بيانات Google"، ثم اختَر من القائمة "التحقّق من العنوان" >
"اختيار واجهة برمجة التطبيقات Address Validation API"
. - عند التنفيذ لأول مرة، ستظهر رسالة "مطلوب إذن"
للسماح بالوصول إلى Apps Script.
بنود خدمة Google Maps Platform
يتم تقديم الحل لأغراض الاختبار على مجموعة محدودة من العناوين:
يُسمح بفترة التخزين المؤقت: 30 يومًا تقويميًا متتاليًا، وبعدها على "العميل"
(1) حذف "محتوى خرائط Google" المخزن مؤقتًا أو (2) الاستبدال ببيانات "المستخدم النهائي"
المقدّمة من خلال تأكيد أو تصحيح "المستخدم النهائي". يُرجى الرجوع إلى جدول 11.3.1 (أذونات التخزين المؤقت) في بنود خدمة "منصة خرائط Google":
- placeId
- الموقع: قيم خطوط العرض، وقيم خطوط الطول
- القرار
- formattedAddress
- postalAddress
- addressComponent: componentName
- عنوان موحّد لبيانات خدمة USPS
الاعتبارات
- الأداء: يمكنك المتابعة في أجزاء من 1,000 صف بحد أقصى في المرة الواحدة. يمكن أن يتم إيقاف النص البرمجي في نهاية المطاف، على سبيل المثال عند تجاوز الحصة المسموح بها لواجهة برمجة التطبيقات في الثانية، يمكنك المتابعة من الصف الذي توقّف عنده النص البرمجي.
- يمكنك الوصول إلى الرمز من القائمة > الإضافات > Apps Script وإنشاء نسختك الخاصة من النص البرمجي المخصّصة لاحتياجاتك.
- الأسعار لـ Address Validation API
الخاتمة
تسمح واجهة برمجة تطبيقات التحقق من صحة العناوين في جداول بيانات Google لغير المطورين ببدء الاستعلام عن واجهة برمجة تطبيقات التحقق من صحة العناوين وفهم كيف يمكن أن تكون استراتيجية بالنسبة
لأنشطتهم التجارية. يحاول هذا المستند توضيح كيف يمكن لأي شخص بدء الاستعلام عن واجهة برمجة التطبيقات
من خلال إنشاء مفتاح واجهة برمجة تطبيقات واستخدام نموذج "جداول بيانات Google" المقدَّم.
الإجراءات التالية
مراجع إضافية مقترَحة:
- التحقّق من صحة العنوان لدفع فواتير التجارة الإلكترونية
- مكتبة "التحقق من العناوين" ذات الأعداد الكبيرة من العناوين
المساهمون
تُعدّ هذه المقالة من إعداد Google. كتب المساهمون التاليون هذه المقالة في الأصل.
المؤلف الرئيسي:
توماس Anglaret | مهندس حلول\