ממשק לאימות כתובות ב-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.

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

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

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

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

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

התנאים וההגבלות של פלטפורמת מפות Google

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

• 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 | מהנדס פתרונות\