التحقّق من صحة العناوين في "جداول بيانات Google"

الهدف

في هذا المستند، سنتعرّف على كيفية استخدام Address Validation API في "جداول بيانات Google" لاختبار الخدمة بطريقة سريعة وبسيطة.

إذا لم تكن مطوّرًا وتريد العمل على البيانات الواردة من منصة خرائط Google، مثل Address Validation API، قد تحتاج إلى طريقة لبدء استخدام الخدمة بدون مساعدة كبيرة من الفِرق الفنية.

حالات الاستخدام

لنتعرّف الآن على حالات الاستخدام التي تكون فيها Address Validation API في "جداول بيانات Google" مفيدة:

  • التجربة: قد ترغب مؤسستك في اختبار إمكانات Address Validation API بسرعة باستخدام عناوينك الخاصة.
  • المقارنة: يمكنك مقارنة نتائج Address Validation API بنتائج نقاط النهاية الأخرى، مثل Geocoding API أو Places API.
  • اختبار A/B: يمكنك إجراء اختبار A/B على نُسخ مختلفة من مجموعة البيانات نفسها لمعرفة ما قد يقدّم نتائج أكثر ملاءمة.

نموذج من "جداول بيانات Google"

الحلّ هو جدول بيانات Google يتضمّن دوال برمجة تطبيقات مخصّصة تنفّذ الطلبات بالتسلسل إلى Address Validation API.

يمكنك تشغيل العناوين من خلال واجهة برمجة التطبيقات باتّباع الخطوات التالية (يتطلّب ذلك حساب Google ومفتاح واجهة برمجة التطبيقات):

  1. انتقِل إلى نموذج جدول البيانات، ومن القائمة، اختَر: ملف > إنشاء نسخة
    (عليك تسجيل الدخول إلى حسابك على Google أو إنشاء حساب)
  2. فعِّل Address Validation API وأنشئ مفتاح واجهة برمجة تطبيقات من Cloud Console.
  3. في علامة التبويب "مفتاح واجهة برمجة التطبيقات + لوحة البيانات" (API Key + Dashboard) في "جداول بيانات Google"، استبدِل الخلية B2 بمفتاح واجهة برمجة التطبيقات.
  4. نسخ العناوين ولصقها في النموذج (في ورقة بيانات منفصلة لتنسيق البيانات: دمج رقم الشارع والاسم والمدينة والرمز البريدي)
  5. اختَر خلايا في "جداول بيانات Google"، ثم اختَر من القائمة "التحقّق من العنوان" > "اختيار Address Validation API"
  6. عند التنفيذ لأول مرة، ستظهر رسالة "مطلوب الحصول على إذن" لمنح إذن الوصول إلى "برمجة تطبيقات Google".



بنود خدمة "منصة خرائط Google"

يتم توفير "الحل" لأغراض الاختبار على مجموعة محدودة من العناوين: فترة التخزين المؤقت المسموح بها: 30 يومًا تقويميًا متتاليًا، وبعد ذلك يجب على "العميل" (1) حذف "محتوى خرائط Google" المخزَّن مؤقتًا أو (2) استبداله ببيانات "المستخدم النهائي" المقدَّمة من خلال تأكيد "المستخدم النهائي" أو تصحيحه. يُرجى الرجوع إلى الجدول 11.3.1 (أذونات التخزين المؤقت) في بنود خدمة "منصة خرائط Google":

  • placeId
  • الموقع الجغرافي: قيم خطوط العرض وقيم خطوط الطول
  • verdict
  • formattedAddress
  • postalAddress
  • addressComponent: componentName
  • USPS Data standardizedAddress

الاعتبارات

  • الأداء: يمكنك المتابعة في مجموعات من 1000 صفّ وليس أكثر في المرة الواحدة. قد يتوقف النص البرمجي في النهاية، على سبيل المثال عند تجاوز حصة واجهة برمجة التطبيقات في الثانية، ويمكنك المتابعة من الصف الذي توقف فيه النص البرمجي.
  • يمكنك الوصول إلى الرمز من خلال "القائمة" > "الإضافات" > "برمجة تطبيقات Google" وإنشاء نسختك الخاصة من النص البرمجي بما يتناسب مع احتياجاتك
  • أسعار Address Validation API

الخاتمة

تتيح واجهة Address Validation API في "جداول بيانات Google" لغير المطوّرين بدء إرسال طلبات البحث إلى واجهة Address Validation API وفهم كيف يمكن أن تكون استراتيجية لنشاطهم التجاري. يوضّح هذا المستند كيف يمكن لأي مستخدم بدء إرسال طلبات البحث إلى واجهة برمجة التطبيقات من خلال إنشاء مفتاح واجهة برمجة التطبيقات واستخدام نموذج "جداول بيانات Google" المقدَّم.

الإجراءات التالية

قراءات إضافية مقترَحة:


المساهمون

وتتولى Google صيانة هذه المقالة. وقد كتبه في الأصل المساهمون التاليون.
المؤلف الرئيسي:

توماس أنغلاريت | مهندس حلول\