יעד
במסמך הזה נסביר איך להשתמש ב-Address Validation API ב-Google Sheets כדי לבדוק את השירות במהירות ובקלות.
אנחנו לא מפתחים, אבל מוכנים לעבוד עם נתונים שמגיעים מהפלטפורמה של מפות Google, כמו Address Validation API, ייתכן שתרצו למצוא דרך להתחיל לעבוד עם השירות בלי לקבל עזרה נוספת מהצוותים הטכניים.
תרחישים לדוגמה
עכשיו נסביר על תרחישים לדוגמה שבהם אפשר להשתמש ב-Address Validation API ב-Google Sheets:
- גרסת ניסיון: כעסק, מומלץ לבדוק במהירות את היכולות של ה-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 Console.
- בכרטיסייה Sheets 'מפתח API + מרכז בקרה', מחליפים את תא B2 במפתח ה-API.
- מעתיקים/מדביקים כתובות בתבנית (בגיליון נפרד כדי לעצב את הנתונים: שרשור של מספר בית, שם, עיר, מיקוד)
- בוחרים תאים ב-Sheets ואז בוחרים מהתפריט 'Address Validation' > 'בחירת API לאימות כתובת'
- בהפעלה הראשונה תופיע ההודעה 'נדרשת הרשאה' כדי לתת גישה ל-Apps Script.
התנאים וההגבלות של פלטפורמת מפות Google
הפתרון ניתן למטרות בדיקה בקבוצה מוגבלת של כתובות:
תקופת השמירה במטמון: 30 ימים קלנדריים רצופים, ולאחר מכן על הלקוח (1) למחוק את התוכן השמור במפות Google או (2) להחליף אותו בנתונים של משתמשי קצה שסופקו על ידי אישור או תיקון של משתמשי קצה. עיינו בטבלה 11.3.1 לתנאים ולהגבלות של הפלטפורמה של מפות Google (הרשאות
שמירה במטמון):
- placeId
- מיקום: ערכי קווי רוחב, ערכים של קווי אורך
- תוצאה
- formattedAddress
- postalAddress
- addressComponent: ComponentName
- כתובת סטנדרטית של נתוני USPS
לתשומת ליבכם
- ביצועים: המשך במקטעים של 1,000 שורות, אך לא יותר בבת אחת. הסקריפט יכול להפסיק בסופו של דבר, למשל במקרה של חריגה ממכסת ה-API לשנייה, הוא יכול להמשיך מהשורה שבה הוא הופסק.
- אפשר לגשת לקוד דרך 'תפריט' > 'תוספים' > 'Apps Script', ולהתאים אישית את הגרסה של הסקריפט לפי הצורך
- תמחור ב-Address Validation API.
סיכום
רק משתמשים שלא מפתחים יכולים לשלוח שאילתות לגבי Address Validation API ב-Google Sheets כדי להבין איך הוא יכול להיות אסטרטגי לעסק שלהם. במסמך הזה נסביר איך כל אחד יכול להתחיל לשלוח שאילתות ל-API באמצעות יצירה של מפתח API ושימוש בתבנית Google Sheets שסופקה.
הפעולות הבאות
הצעות לקריאה נוספת:
תורמים
Google מנהלת את המאמר הזה. תורמי התוכן הבאים כתבו אותו במקור.
המחבר הראשי:
תומאס אנגלרט | מהנדס פתרונות\