אימות כתובות ב-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: בדיקת וריאציות של אותו מערך נתונים כדי להבין מה יכול לספק תוצאות מתאימות יותר.
  

תבנית של Google Sheets

הפתרון הוא Google Sheets עם פונקציות מותאמות אישית של Apps Script, שיבצעו בקשות ברצף אל Address Validation API.

הערה: הדוגמה הזו מיועדת רק להדרכה בנושא שילוב. חשוב לוודא את האיכות לפני שמשתמשים בהם באפליקציות. התמיכה זמינה במוצרים כמו Address Validation API שמשמש בדוגמה הזו.

כדי להריץ כתובות באמצעות ה-API, צריך לפעול לפי השלבים הבאים (נדרש חשבון Google ומפתח API):

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

זהירות: כדי לאבטח את מפתח ה-API, צריך להגביל את השימוש בו ל-Address Validation API בלבד. כדי למנוע שימוש לא צפוי, חשוב לשתף את הגיליון רק עם גורמים מהימנים, ולמחוק את המפתח ב-Console אחרי שמסיימים את הניתוח.

הערה: כדי לעמוד בתנאים ובהגבלות של Google Maps Platform, חשוב למחוק את הגיליון האלקטרוני אחרי 30 ימים, כי ב-Google Sheets יש היסטוריה מובנית.

התנאים של Google Maps Platform

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

• placeId
  
• מיקום: ערכי קו רוחב, ערכי קו אורך
  
• תוצאה
  
• formattedAddress
  
• postalAddress
  
• addressComponent: componentName
  
• נתונים של USPS בפורמט סטנדרטיAddress
  

שיקולים

• ביצועים: מומלץ להמשיך בחלקים של 1,000 שורות ולא יותר בבת אחת. יכול להיות שהסקריפט ייעצר, למשל אם תהיה חריגה ממכסת ה-API לשנייה, ואז הוא ימשיך מהשורה שבה הוא נעצר.
• אפשר לגשת לקוד דרך תפריט > תוספים > Apps Script וליצור גרסה משלכם של הסקריפט בהתאמה לצרכים שלכם.
• תמחור של Address Validation API.

סיכום

‫Address Validation API ב-Google Sheets מאפשר למי שאינם מפתחים להתחיל לשלוח שאילתות אל Address Validation API ולהבין איך הוא יכול לתרום לעסק שלהם. במסמך הזה ננסה להדגים איך כל אחד יכול להתחיל לשלוח שאילתות ל-API על ידי יצירת מפתח API ושימוש בתבנית Google Sheets שסופקה.

הפעולות הבאות

הצעות לקריאה נוספת:

• Address Validation בתהליך סיום הקנייה באתרים למסחר אלקטרוני
• ספריית אימות כתובות בנפח גבוה

תורמים

‫Google מתחזקת את המאמר הזה. הכותבים המקוריים של המאמר הזה הם:
המחבר הראשי:

Thomas Anglaret | Solutions Engineer\