هدف اصلی
در این سند، نحوه استفاده از Address Validation API در «کاربرگ‌نگار Google» را بررسی می‌کنیم تا بتوانید این سرویس را به‌سرعت و به‌آسانی آزمایش کنید.
به‌عنوان فردی که توسعه‌دهنده نیستید، اگر مایلید با داده‌های دریافتی از Google Maps Platform مثل Address Validation API کار کنید، شاید بخواهید راهی برای شروع کار با این سرویس بدون کمک زیاد از تیم‌های فنی پیدا کنید.
موارد استفاده
اکنون بیایید موارد استفاده Address Validation API در «کاربرگ‌نگار Google» را بررسی کنیم:
- آزمایشی: به‌عنوان یک کسب‌وکار، ممکن است بخواهید به‌سرعت قابلیت‌های Address Validation API را بااستفاده از نشانی‌های خودتان آزمایش کنید.
- مقایسه: نتایج Address Validation API را با نتایج سایر نقاط پایانی مانند Geocoding API یا Places API مقایسه کنید.
- آزمایش A/B: انواع آزمایش A/B از یک مجموعه داده برای درک اینکه چه چیزی ممکن است نتایج مناسب‌تری ارائه دهد.
الگوی «کاربرگ‌نگار Google»
این راه‌حل یک کاربرگ‌نگار Google است که با توابع سفارشی Apps Script ارائه می‌شود که درخواست‌ها را به‌ترتیب به Address Validation API ارسال می‌کند.
می‌توانید با دنبال کردن مراحل زیر، نشانی‌ها را ازطریق API اجرا کنید (به حساب Google و کلید API نیاز است):
- به نمونه صفحه‌گسترده بروید و از منو، «فایل > ایجاد کپی» را انتخاب کنید
(باید به سیستم حساب Google خود وارد شوید یا حسابی ایجاد کنید) - Address Validation
API را فعال کنید و «کلید میانای برنامه‌سازی کاربردی» را از کنسول
Cloud تولید کنید.
- در برگه «کلید میانای برنامه‌سازی کاربردی + داشبورد» در «کاربرگ‌نگار»، سلول B2 را با «کلید میانای برنامه‌سازی کاربردی» خودتان جایگزین کنید.
- نشانی‌ها را در الگو کپی/جای‌گذاری کنید (در صفحه‌گسترده‌ای جداگانه برای قالب‌بندی داده‌ها: شماره خیابان، نام، شهر، کد پستی را به‌هم متصل کنید)
- سلول‌های برگه‌ها را انتخاب کنید و سپس از منو «اعتبارسنجی نشانی» >
«انتخاب Address Validation API» را انتخاب کنید
- در اولین اجرا، پیام «مجوز لازم است» برای ارائه دسترسی به Apps Script نشان داده می‌شود.
شرایط پلتفورم Google Maps
«راهکار» برای اهداف آزمایشی در مجموعه محدودی از نشانی‌ها ارائه می‌شود:
دوره مجاز ذخیره در حافظه نهان: ۳۰ روز تقویمی متوالی، که پس‌از آن «مشتری» باید
(۱) «محتوای Google Maps» ذخیره‌شده در حافظه نهان را حذف کند یا (۲) آن را با داده‌های «کاربر نهایی»
ارائه‌شده ازطریق تأیید یا اصلاح «کاربر نهایی» جایگزین کند. به جدول ۱۱.۳.۱ (مجوزهای ذخیره‌سازی در حافظه نهان) در «شرایط خدمات Google Maps Platform» مراجعه کنید:
- placeId
- مکان: مقادیر عرض جغرافیایی، مقادیر طول جغرافیایی
- حکم
- formattedAddress
- postalAddress
- addressComponent: componentName
- USPS Data standardizedAddress
ملاحظات
- عملکرد: در دسته‌های ۱۰۰۰ ردیفی ادامه دهید، نه بیشتر در یک‌بار. اسکریپت ممکن است درنهایت متوقف شود، مثلاً وقتی از سهمیه API در ثانیه فراتر می‌رود، از ردیفی که اسکریپت متوقف شده است ادامه دهید.
- می‌توانید ازطریق «منو > افزونه‌ها > Apps Script» به کد دسترسی پیدا کنید و نسخه خودتان را از دستورگان متناسب با نیازتان بسازید
- قیمت‌گذاری برای Address Validation API.
نتیجه‌گیری
Address Validation API در «کاربرگ‌نگار Google» به غیرتوسعه‌دهندگان امکان می‌دهد که
پرس‌وجو از Address Validation API را شروع کنند و متوجه شوند که این API چگونه می‌تواند برای کسب‌وکارشان
استراتژیک باشد. این سند تلاش می‌کند نشان دهد که چگونه هر کسی می‌تواند با ایجاد یک کلید API و استفاده از الگوی کاربرگ‌نگار Google ارائه‌شده، شروع به پرس‌وجو از API کند.
کنش‌های بعدی
مطالعه بیشتر پیشنهادی:
همیاران
Google این مقاله را نگهداری می‌کند. همیاران زیر در ابتدا آن را نوشته‌اند.
نویسنده اصلی:
توماس آنگلارت | مهندس راه‌حل‌ها\