الهدف
في هذا المستند، سنتناول كيفية استخدام Address Validation API في "جداول بيانات Google" لاختبار الخدمة بطريقة سريعة وسهلة.
إذا لم تكن مطوّرًا، ولكنك تريد العمل مع بيانات واردة من منصة خرائط Google، مثل واجهة برمجة التطبيقات الخاصة بخدمة التحقّق من صحة العناوين، قد تحتاج إلى طريقة للبدء في استخدام الخدمة بدون مساعدة كبيرة من الفِرق الفنية.
حالات الاستخدام
لنتعرّف الآن على حالات الاستخدام التي تكون فيها واجهة Address Validation API في "جداول بيانات Google" مفيدة:
- التجربة: بصفتك نشاطًا تجاريًا، قد تحتاج إلى اختبار إمكانات واجهة برمجة التطبيقات Address Validation API بسرعة باستخدام عناوينك الخاصة.
- المقارنة: قارِن نتائج Address Validation API بنتائج نقاط نهاية أخرى، مثل Geocoding API أو Places API.
- اختبار A/B: يمكنك اختبار صيغ مختلفة من مجموعة البيانات نفسها لمعرفة ما قد يقدّم نتائج أكثر ملاءمة.
نموذج من "جداول بيانات Google"
الحلّ هو جدول بيانات Google يتضمّن دوال برمجة تطبيقات Google مخصّصة تنفّذ الطلبات بالتسلسل إلى واجهة برمجة التطبيقات الخاصة بخدمة "التحقّق من صحة العناوين".
يمكنك تشغيل العناوين من خلال واجهة برمجة التطبيقات باتّباع الخطوات أدناه (يتطلّب ذلك حسابًا على Google ومفتاح واجهة برمجة تطبيقات):
- انتقِل إلى جدول البيانات
النموذجي
ومن القائمة، اختَر: ملف > إنشاء نسخة
(عليك تسجيل الدخول إلى حسابك على Google أو إنشاء حساب) - فعِّل Address Validation API
وأنشئ مفتاح واجهة برمجة تطبيقات من Cloud
Console.
- في علامة التبويب "مفتاح واجهة برمجة التطبيقات + لوحة البيانات" في "جداول بيانات Google"، استبدِل الخلية B2 بمفتاح واجهة برمجة التطبيقات.
- نسخ العناوين ولصقها في النموذج (في ورقة منفصلة لتنسيق البيانات: دمج رقم الشارع واسمه والمدينة والرمز البريدي)
- اختَر خلايا في جداول بيانات Google، ثم اختَر من القائمة "التحقّق من صحة العنوان" > "اختيار واجهة برمجة التطبيقات للتحقّق من صحة العنوان"
- عند التنفيذ لأول مرة، ستظهر الرسالة "مطلوب تفويض" لمنح إذن الوصول إلى 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 صيانة هذه المقالة. كتب المساهمون التاليون هذا المحتوى في الأصل.
المؤلف الرئيسي:
توما أنغلاريه | مهندس حلول\