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