מטרה
במסמך הזה נסביר איך להשתמש ב-Address Validation API ב-Google Sheets כדי לבדוק את השירות בצורה מהירה וקלה.
אם אתם לא מפתחים, אבל אתם רוצים לעבוד עם נתונים שמגיעים מפלטפורמת מפות Google, כמו Address Validation API, תוכלו למצוא דרך להתחיל להשתמש בשירות בלי הרבה עזרה מצוותים טכניים.
תרחישים לדוגמה
עכשיו נבין אילו תרחישים לדוגמה מתאימים לשימוש ב-Address Validation API ב-Google Sheets:
- תקופת ניסיון: בעלי עסקים יכולים לבדוק במהירות את היכולות של Address Validation API באמצעות כתובות משלהם.
- השוואה: השוואה בין התוצאות של Address Validation API לבין תוצאות של נקודות קצה אחרות, כמו Geocoding API או Places API.
- בדיקת A/B: בדיקת A/B של וריאנטים של אותו מערך נתונים כדי להבין מה עשוי לספק תוצאות מתאימות יותר.
תבנית של Google Sheets
הפתרון הוא גיליון אלקטרוני ב-Google Sheets שמגיע עם פונקציות מותאמות אישית של Apps Script, שיבצעו בקשות ברצף ל-Address Validation API.
אפשר להריץ כתובות באמצעות ה-API לפי השלבים הבאים (נדרש חשבון Google ומפתח API):
- עוברים אל הגיליון האלקטרוני לדוגמה ובתפריט בוחרים באפשרות: קובץ > יצירת עותק
(צריך להתחבר לחשבון Google או ליצור חשבון חדש) - מפעילים את Address Validation API ויוצרים מפתח API מתוך מסוף Cloud.
- בכרטיסייה 'מפתח API + מרכז הבקרה' ב-Sheets, מחליפים את תא B2 במפתח ה-API.
- מעתיקים/מדביקים את הכתובות בתבנית (בגיליון נפרד כדי לעצב את הנתונים: שרשור המספר ברחוב, השם, העיר והמיקוד)
- בוחרים תאים בגיליון האלקטרוני ואז בתפריט בוחרים באפשרות 'אימות כתובות' > 'בחירת API לאימות כתובות'
- בהפעלה הראשונה תוצג ההודעה 'נדרשת הרשאה' כדי לספק גישה ל-Apps Script.
התנאים וההגבלות של פלטפורמת מפות Google
הפתרון מסופק למטרות בדיקה בקבוצה מוגבלת של כתובות: תקופת האחסון במטמון מותרת: 30 ימים קלנדריים רצופים, לאחר מכן הלקוח חייב (1) למחוק את התוכן של מפות Google שנשמר במטמון או (2) להחליף אותו בנתונים של משתמש הקצה שסופקו באמצעות אישור או תיקון של משתמש הקצה. אפשר לעיין בטבלה 11.3.1 (הרשאות לשמירת נתונים במטמון) בתנאים וההגבלות של הפלטפורמה של מפות Google:
- placeId
- מיקום: ערכי קו רוחב, ערכי קו אורך
- verdict
- formattedAddress
- postalAddress
- addressComponent: componentName
- USPS Data standardizedAddress
לתשומת ליבכם
- ביצועים: מומלץ להמשיך בקטעים של 1,000 שורות לכל היותר בבת אחת. יכול להיות שהסקריפט יפסיק בסופו של דבר, למשל אם תחרגו ממכסת הבקשות ל-API לשנייה. במקרה כזה, תצטרכו להמשיך מהשורה שבה הסקריפט הופסק.
- אפשר לגשת לקוד דרך תפריט > תוספים > Apps Script וליצור גרסה משלכם של הסקריפט בהתאם לצרכים שלכם.
- המחירון של Address Validation API.
סיכום
באמצעות Address Validation API ב-Google Sheets, אנשים שאינם מפתחים יכולים להתחיל לשלוח שאילתות ל-Address Validation API ולהבין איך הוא יכול לשמש אותם באופן אסטרטגי. במסמך הזה נסביר איך כל אחד יכול להתחיל לשלוח שאילתות ל-API על ידי יצירת מפתח API ושימוש בתבנית של Google Sheets שסופקה.
הפעולות הבאות
מקורות מידע נוספים:
תורמים
Google מנהלת את המאמר הזה. הכותבים הבאים כתבו אותו במקור.
המחבר הראשי:
Thomas Anglaret | מהנדס פתרונות\