ממשק לאימות כתובות ב-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. עוברים אל Sample Spreadsheet (גיליון אלקטרוני לדוגמה) ובתפריט בוחרים באפשרות File (קובץ) > Make a copy (יצירת עותק)
   (צריך להתחבר לחשבון Google או ליצור חשבון)
   .
2. מפעילים את Address Validation API ומפיקים מפתח API מתוך Cloud Console.
   
3. בכרטיסייה 'API Key + Dashboard' ב-Sheets, מחליפים את התא B2 במפתח ה-API שלכם.
   
4. העתקה/הדבקה של כתובות בתבנית (בגיליון נפרד כדי לעצב את הנתונים: שרשור של המספר ברחוב, שם הרחוב, העיר והמיקוד)
   
5. בוחרים תאים בגיליון האלקטרוני ואז בוחרים בתפריט באפשרות 'אימות כתובות' > 'בחירת API לאימות כתובות'
   
6. בפעם הראשונה שמריצים את הסקריפט, מוצגת ההודעה 'נדרשת הרשאה' כדי לתת גישה ל-Apps Script.
   

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

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

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

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

• placeId
  
• מיקום: ערכי קו רוחב, ערכי קו אורך
  
• תוצאה
  
• formattedAddress
  
• postalAddress
  
• addressComponent: componentName
  
• כתובת
  

לתשומת ליבכם

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

סיכום

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

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

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

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

תורמים

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

Thomas Anglaret | Solutions Engineer\