אימות כתובות ב-Google Sheets

מטרה

במאמר הזה נסביר איך להשתמש ב-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):

  1. עוברים אל הגיליון האלקטרוני לדוגמה, ובתפריט בוחרים באפשרות "קובץ" > "יצירת עותק"
    (צריך להתחבר לחשבון Google או ליצור חשבון)
  2. מפעילים את Address Validation API ויוצרים מפתח API מ-Cloud Console.
  3. בכרטיסייה "API Key + Dashboard" ב-Sheets, מחליפים את התא B2 במפתח ה-API.
  4. מעתיקים ומדביקים את הכתובות בתבנית (בגיליון נפרד כדי לעצב את הנתונים: משרשרים את מספר הבית, שם הרחוב, העיר והמיקוד)
  5. בוחרים תאים בגיליון ואז בוחרים בתפריט "אימות כתובת" > "בחירת Address Validation API"
  6. בפעם הראשונה שתפעילו את הסקריפט, תופיע ההודעה "נדרשת הרשאה" כדי לתת גישה ל-Apps Script.



התנאים של Google Maps Platform

הפתרון מסופק למטרות בדיקה בקבוצה מוגבלת של כתובות: תקופת השמירה במטמון המותרת: 30 ימים קלנדריים רצופים, שלאחריהם הלקוח חייב (1) למחוק את התוכן של מפות Google שנשמר במטמון או (2) להחליף אותו בנתוני משתמש קצה שסופקו באמצעות אישור או תיקון של משתמש הקצה. עיינו בטבלה 11.3.1 (הרשאות לשמירה במטמון) בתנאים ובהגבלות של הפלטפורמה של מפות Google:

  • placeId
  • מיקום: ערכי קו רוחב, ערכי קו אורך
  • החלטה
  • 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 מתחזקת את המאמר הזה. הכותבים הבאים כתבו אותו במקור.
המחבר הראשי:

תומאס אנגלרט | מהנדס פתרונות\