واجهة برمجة التطبيقات لإثبات صحة العنوان في "جداول بيانات Google"

الهدف

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

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

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

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

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

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

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

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

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



بنود خدمة Google Maps Platform

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

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

الاعتبارات

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

الخاتمة

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

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

محتوى إضافي للقراءة:


المساهمون

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

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