Address Validation API در Google Sheets

هدف

در این سند، به نحوه استفاده از API اعتبارسنجی آدرس در Google Sheets خواهیم پرداخت تا سرویس را به روشی سریع و آسان آزمایش کنیم.

به عنوان یک غیر توسعه‌دهنده، در حالی که مایل به کار با داده‌هایی مانند API اعتبارسنجی آدرس از پلتفرم نقشه‌های گوگل هستید، ممکن است بخواهید راهی برای شروع کار با این سرویس بدون کمک زیاد تیم‌های فنی پیدا کنید.

موارد استفاده

حال بیایید موارد استفاده‌ای که API اعتبارسنجی آدرس در گوگل شیت مفید است را بررسی کنیم:

• نسخه آزمایشی : به عنوان یک کسب و کار، ممکن است بخواهید به سرعت قابلیت‌های API اعتبارسنجی آدرس را با استفاده از آدرس‌های خودتان آزمایش کنید.
• مقایسه : نتایج API اعتبارسنجی آدرس را با نتایج سایر نقاط پایانی مانند API ژئوکدینگ یا API مکان‌ها مقایسه کنید.
• آزمون A/B : انواع آزمون A/B از همان مجموعه داده برای درک اینکه کدام یک ممکن است نتایج مناسب‌تری ارائه دهد.
  

الگوی گوگل شیت

راه حل، یک Google Sheets است که با توابع Apps Script سفارشی ارائه می‌شود و درخواست‌ها را به ترتیب به API اعتبارسنجی آدرس (Address Validation API) ارسال می‌کند.

نکته: این مثال فقط برای راهنمایی ادغام در نظر گرفته شده است. شما باید قبل از استفاده در برنامه‌های خود از کیفیت آن اطمینان حاصل کنید. پشتیبانی برای محصولاتی مانند API اعتبارسنجی آدرس که در این مثال استفاده شده است، موجود است.

شما می‌توانید آدرس‌ها را با استفاده از API و با دنبال کردن مراحل زیر اجرا کنید (به یک حساب گوگل و یک کلید API نیاز دارید):

1. به صفحه گسترده نمونه بروید و از منو، گزینه File > Make a copy را انتخاب کنید.
   (باید وارد حساب گوگل خود شوید یا یکی بسازید)
   
2. API اعتبارسنجی آدرس را فعال کنید و یک کلید API از Cloud Console ایجاد کنید.
   
3. در برگه «کلید API + داشبورد»، سلول B2 را با کلید API خود جایگزین کنید.
   
4. آدرس‌ها را در الگو کپی/پیست کنید (در یک برگه جداگانه برای قالب‌بندی داده‌ها: شماره خیابان، نام، شهر، کد پستی را به هم وصل کنید)
   
5. سلول‌های شیت را انتخاب کنید و سپس از منوی «اعتبارسنجی آدرس» > «انتخاب API اعتبارسنجی آدرس» را انتخاب کنید.
   
6. در اولین اجرا، پیام «مجوز لازم است» برای دسترسی به اسکریپت برنامه‌ها ظاهر می‌شود.
   

احتیاط: کلید API خود را با محدود کردن استفاده از آن فقط به API اعتبارسنجی آدرس، ایمن کنید. برای جلوگیری از استفاده غیرمنتظره، مطمئن شوید که برگه خود را فقط با اشخاص مورد اعتماد به اشتراک می‌گذارید و پس از اتمام تجزیه و تحلیل، کلید خود را در کنسول حذف کنید.

نکته: برای رعایت شرایط پلتفرم نقشه‌های گوگل، حتماً صفحه گسترده را پس از 30 روز حذف کنید زیرا گوگل شیت دارای تاریخچه داخلی است.

شرایط پلتفرم نقشه گوگل

این راهکار برای اهداف آزمایشی روی مجموعه‌ای محدود از آدرس‌ها ارائه شده است: دوره ذخیره‌سازی مجاز: 30 روز تقویمی متوالی، پس از آن مشتری باید (1) محتوای ذخیره‌سازی شده نقشه‌های گوگل را حذف کند یا (2) آن را با داده‌های کاربر نهایی که از طریق تأیید یا اصلاح کاربر نهایی ارائه شده است، جایگزین کند. به جدول شرایط خدمات پلتفرم نقشه‌های گوگل 11.3.1 (مجوزهای ذخیره‌سازی) مراجعه کنید:

• شناسه مکان
  
• مکان: مقادیر عرض جغرافیایی، مقادیر طول جغرافیایی
  
• حکم
  
• آدرس قالب‌بندی‌شده
  
• آدرس پستی
  
• آدرسکامپوننت: componentName
  
• داده‌های استاندارد شده‌ی USPSآدرس
  

ملاحظات

• عملکرد: در بخش‌های ۱۰۰۰ سطری اجرا شود، نه بیشتر از آن به طور همزمان. اسکریپت می‌تواند در نهایت متوقف شود، برای مثال، وقتی از سهمیه API در ثانیه فراتر می‌رود، از سطری که اسکریپت متوقف شده است، ادامه یابد.
• شما می‌توانید از طریق منو > افزونه‌ها > اسکریپت برنامه‌ها به کد دسترسی پیدا کنید و نسخه خودتان از اسکریپت را متناسب با نیازتان بسازید.
• قیمت‌گذاری برای API اعتبارسنجی آدرس.

نتیجه‌گیری

API اعتبارسنجی آدرس در Google Sheets به افراد غیر توسعه‌دهنده اجازه می‌دهد تا شروع به پرس‌وجو از API اعتبارسنجی آدرس کنند و بفهمند که چگونه می‌تواند برای کسب‌وکارشان استراتژیک باشد. این سند تلاش می‌کند تا نشان دهد که چگونه هر کسی می‌تواند با ایجاد یک کلید API و استفاده از الگوی ارائه شده Google Sheets، پرس‌وجو از API را آغاز کند.

اقدامات بعدی

پیشنهاد مطالعه بیشتر:

• اعتبارسنجی آدرس برای پرداخت در فروشگاه اینترنتی
• کتابخانه اعتبارسنجی آدرس با حجم بالا

مشارکت‌کنندگان

گوگل این مقاله را نگهداری می‌کند. نویسندگان زیر در ابتدا آن را نوشته‌اند.
نویسنده اصلی:

توماس انگلارت | مهندس راهکارها