שאלות נפוצות

תחילת העבודה

מה זה Google Vision API?
Google Visualization API מאפשר לכם ליצור תרשימים ואפליקציות דיווח על נתונים מובְנים, ועוזר לשלב אותם ישירות באתר.
מה אפשר לעשות עם תצוגה חזותית של API?
בעזרת Google Visualization API, אפשר לגשת לנתונים מובְנים שנוצרו באופן מקומי בדפדפן או לאחזר אותם ממקורות נתונים נתמכים, בפורמט טבלה פשוט. אפשר גם להטמיע מקור נתונים משלך, כמקור נתונים ל-Visual Vision, ולאפשר לכל אפליקציה או תצוגה חזותית שתומכת בתצוגה חזותית לגשת לנתונים שלך. הפורמט מאפשר שימוש באפליקציות דיווח, ניתוח או תרשים. כך ניתן להציג את הנתונים ו/או להוסיף פונקציונליות חדשה לאפליקציות, כמו Google Sheets.
היכן ניתן למצוא תיעוד עבור ממשק ה-API לתצוגה חזותית?
המדריך למפתחים וכל המסמכים הרלוונטיים האחרים זמינים בכתובת https://developers.google.com/chart/interactive/docs.
איך יוצרים תרשים חדש?
הדרך הטובה ביותר להתחיל היא לקרוא את המבוא ואת הקטע התחלה מהירה.
מהי כתובת URL של מקור נתונים?
כתובת URL של מקור נתונים היא המזהה הייחודי של כתובת ה-URL של מקור נתונים ב-Visual API. כתובת URL של מקור נתונים יכולה לכלול גם פרמטרים של שפת השאילתות בתרשים. במקרה כזה, מתבצעת שאילתה (כמו מיון, קיבוץ וכו') במקור הנתונים לפני אחזור הנתונים.
איפה אפשר למצוא קוד לדוגמה של אפליקציות תרשים באמצעות ה-API של Visualizer?
ניתן למצוא קוד לדוגמה בתיעודקוד לדוגמה.
האם אפליקציית Flash יכולה לגשת לממשק ה-API להצגה חזותית?
בהחלט. ממשק ה-API להצגה חזותית משתמש ב-JavaScript API, אבל יש ספריות שמאפשרות לאפליקציות Flash להתחבר לקוד JavaScript. ספרייה כזו אפשר למצוא בקלות בכתובת http://code.google.com/p/swfobject. בהמשך מפורטות בעיות שקשורות לבעיות פיתוח שמשפיעות על Flash.
איך מטמיעים מקור נתונים?
קוראים את הקטע שימוש ויצירת תרשים, כדי ללמוד איך תרשימים פועלים וקוראים הטמעה של מקור נתונים כדי להבין איך ליצור מקור נתונים. אפשר גם להשתמש בספריית הנתונים של JavaScript ב-Google Chart כדי להשתמש ב-Java במהירות.
האם אפשר לגשת לתרשים מאפליקציית Java?
כן. ספריית התצוגה החזותית של Google עבור ערכת הכלים של Google לאינטרנט (GWT) מאפשרת לכם לגשת לתצוגה החזותית התואמת ל-API מקוד ה-Java שמשולב עם מהדר GWT, ולכתוב את התצוגות החזותיות התואמות ל-API של Java ב-Java באמצעות מקודד GWT. ספריית ההצעות לגרסה נתמכת גם במודל מודל ה-API של תצוגה חזותית.
האם אפשר לגשת לתרשים מאפליקציה שנכתבה באמצעות המהדר של Google Web Toolkit (GWT)?
כן. ספריית התצוגה החזותית של Google עבור ערכת הכלים של Google לאינטרנט (GWT) מאפשרת לכם לגשת לתצוגה החזותית התואמת ל-API מקוד ה-Java שמשולב עם מהדר GWT, ולכתוב את התצוגות החזותיות התואמות ל-API של Java ב-Java באמצעות מקודד GWT. ספריית ההצעות לגרסה נתמכת גם במודל מודל ה-API של תצוגה חזותית.
יש לי שאלה/בעיה אחרת, אל מי לפנות כדי לקבל מידע נוסף?
לקבלת עזרה מקהילת מפתחי ההמחשה, עליך לפרסם את השאלה בקבוצת הדיון של Visualization API של Google. צוות המחשת Google גם משתתף בקבוצה זו כדי לענות על שאלות.

שימוש ב-API

מה ההבדל בין Google Chart API לבין Google Visualization API?

אפשר להשתמש ב-Chart API כדי ליצור בקלות תרשימי תמונות מסוגים שונים, באמצעות שליחה של כתובת URL בפורמט שכוללת את אפשרויות התצורה של הנתונים והתרשים לשרת של Google. ממשק ה-API של התרשים כולל קבוצה סגורה של תרשימים עם אפשרויות שונות. מערכי הנתונים של Chart API מוגבלים לגודל של כתובת URL (כ-2K).

ה-API של תצוגה חזותית מספק דרך לקשר תרשימים ומקורות נתונים באינטרנט ולפרסם אותם:

  • ממשק ה-API להדמיה חזותית מספק API של JavaScript כדי לגשת לתרשימים.
  • גלריית התרשימים שלה כוללת תרשימים שנוצרו על ידי Google, אך היא גם פתוחה לכל צד שלישי ליצירת תצוגות חזותיות התואמות ל-API.
  • תרשימים ותרשימים של ממשק ה-API יכולים להיות כל מה שדפדפן יכול להציג. הנחיה זו כוללת תמונות, JavaScript, וקטורים גרפיים, קובצי Flash וכו'.
  • ניתן לגשת למספר גדול של תרשימים ב-Chart API דרך ה-API להצגה חזותית, אם כי ייתכן שחלק מאפשרויות ההגדרה שלהם לא יהיו זמינות.
  • ממשק ה-API מספק גם פרוטוקול חוטי מתועד ומאפשר לכל אחד לחשוף את מקורות הנתונים שלו לכל תצוגה חזותית של ממשקי API.
  • ל-API יש מודל אירוע מוגדר שמאפשר לתרשימים להשליך ולקבל אירועים וכך לתקשר עם הדף המארח שלהם ו/או תרשימים אחרים בדף.
לאילו מקורות נתונים אפשר לגשת באמצעות תצוגה חזותית של API?
באמצעות ה-API של תצוגה חזותית ניתן לגשת לנתונים באופן מקומי מהדפדפן באמצעות הפורמט הסטנדרטי של DataTable API, או לגשת לכל מקור נתונים שתומך ב-API. אפליקציות ידועות שכבר תומכות ב-API הן Google Sheets ו-Salesforce.com בפלטפורמת המפתחים Force.com. אפשר גם להשתמש בנתונים שלכם כמקור של נתוני תרשים.
האפליקציה שלי מצפה שהנתונים שיתקבלו יהיו בפורמט ספציפי. איך מטפלים במקרים חריגים?
אפשר להשתמש בשיטות getNumberOfColumns() ו-getColumnType() של הכיתה google.visualization.DataTable כדי לבדוק שהנתונים שאתם מקבלים תואמים לציפיות שלכם, ולהפיץ הודעת שגיאה על אי-התאמות.
האם ניתן להטמיע תרשים באתר שלי?
הפעלה של קוד של צד שלישי ישירות באתר מהווה סיכון מהותי. Google אינה מספקת הבטחות או הצהרות בנוגע לביצועי אפליקציות, לאיכות, לאבטחה או לתוכן. ייתכן שנסיר מהגלריות אפליקציות שלא תואמות לתנאים ולהגבלות של Google Visualization API.
האם אפשר להשתמש בתרשימים במצב אופליין?
כדי שתהיה לך אפשרות להשתמש בתכונות האינטראקטיביות של התרשימים של Google, למחשבים של המשתמשים שלך צריכה להיות גישה לכתובת https://www.gstatic.com/charts/Load.js. הסיבה לכך היא שספריות התצוגה החזותיות שנדרשות לדף שלך נטענות באופן דינמי לפני השימוש בהן. הקוד לטעינת הספרייה המתאימה הוא חלק מהסקריפט הכלול, והוא נקרא כשמפעילים את שיטת google.charts.load(). לפי התנאים וההגבלות שלנו אי אפשר להוריד את הקוד של google.charts.load או של google.visualization כדי להשתמש בו אופליין.
האם אפשר להוריד ולארח את קוד התרשים באופן מקומי או ברשת אינטראנט?
מצטערים. התנאים וההגבלות שלנו לא מאפשרים לך להוריד ולשמור את הקוד google.charts.load או google.visualization. עם זאת, אם אין לך צורך באינטראקטיביות בתרשימים של Google, ניתן ליצור צילום מסך של התרשימים ולהשתמש בהם כרצונך.

פתרון בעיות

למה התרשים לא מופיע?

תחילה, יש לבדוק במסוף JavaScript. ב-Chrome, ניתן לגשת אל לוח JavaScript דרך Chrome->תצוגה->מפתחים->לוח JavaScript, או Chrome->כלים->לוח JavaScript. לכל הדפדפנים המודרניים יש לוח JavaScript. ייתכן שתצטרכו להציץ בתפריטים עם שמות כמו "מתקדם" או "כלים למפתחים" כדי למצוא אותו.

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

  • ייתכן שהשתמשת ב-Google Loader באופן שגוי.
    • יש לטעון את התרשימים/load.js רק פעם אחת. המספר הכולל של התרשימים שיש לך בדף האינטרנט צריך להיות שיחה אחת ויחידה, לדוגמה: 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      זה יכול להיות בראש הדף או בגוף הדף, בהתאם למועד שבו רוצים שהטעינה תתבצע.
    • במצב אידיאלי, יש להתקשר ל-google.charts.load פעם אחת בלבד, עם כל החבילות הדרושות לדף האינטרנט. 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
<script>
  google.charts.load("current", {packages: ["corechart", "timeline"]});

  google.charts.setOnLoadCallback(drawBarChart1);
  function drawBarChart1() {
    ...
    var barChart1 = new google.visualization.BarChart(document.getElementById('chart1'));
    ...
  }

  google.charts.setOnLoadCallback(drawBarChart2);
  function drawBarChart2() {
    ...
    var barChart2 = new google.visualization.BarChart(document.getElementById('chart2'));
    ...
  }

  google.charts.setOnLoadCallback(drawTimeline);
  function drawTimeline() {
    ...
    var timeline = new google.visualization.Timeline(document.getElementById('chart3'));
    ...
  }

</script>
<div id="chart1"></div>
...
<div id="chart2"></div>
...
<div id="chart3"></div>
  • לכל תרשים צריך להיות מזהה רכיב ייחודי (למשל, chart1, chart2 בדוגמה שלמעלה).
  • מחפשים שגיאות הקלדה. חשוב לזכור ש-JavaScript היא שפה תלוית אותיות רישיות.

אם עדיין לא מצאת פתרון, אפשר לחפש בקבוצת הדיון של Google Visualization API כדי לבדוק אם מישהו נתקל בבעיה דומה. אם לא הצלחת למצוא פוסט עם תשובה לשאלה שלך, אפשר לפרסם את השאלה בקבוצה וגם קישור לדף אינטרנט שמדגים את הבעיה. אם אפשר, יש לכלול jsjpdle.

למה מספר הימים והימים שלי ביום אחד?
ב-Google התרשימים נעשה שימוש ב-JavaScript, הכולל יצירת אינדקס מבוסס אפס. היום הראשון בחודש הוא 0, והחודשים נעים בין 0 (ינואר) ל-11 (דצמבר). אם הקוד שלך מתבסס על הוספה לאינדקס על בסיס נתונים אחד, יש להחסיר קוד אחד לפני הוספת הנתונים לאובייקט תאריך של JavaScript.
למה התרשימים שלי פועלים בדפדפנים מסוימים, אבל לא בכולם?
אנחנו ממליצים על caniuse.com לקבלת המון מידע על אי-תאימות של דפדפנים. בתרשימים של Google, לפעמים יש בעיות ב-Internet Explorer 8 ובגרסאות קודמות, משתי סיבות:
  • IE8 לא תומך ב-SVG, כך שהתרשימים נכשלים ב-VML שמוגבל יותר.
  • ה-JavaScript של IE8 אינו מאפשר להוסיף פסיקים בסוף הרשימות.
    • למה התרשים המבוסס על Flash לא מופיע כשאני בודק אותו?
    בשל הגדרות האבטחה של Flash, ייתכן שתרשימים מבוססי Flash לא יפעלו כראוי כאשר הגישה אליהם מתבצעת ממיקום קובץ בדפדפן (לדוגמה, file:///c:/webhost/myhost/myviz.html) ולא מכתובת אתר של שרת אינטרנט (למשל, http://www.myhost.com/myviz.html). בדרך כלל מדובר בבעיית בדיקה בלבד; הבעיה אינה מהווה בעיה כאשר ניגשים לתרשים מכתובת http://. אפשר להתגבר על הבעיה הזו כפי שמתואר באתר של Macromedia. באופן כללי מומלץ להימנע מפיתוח Flash.

    מדיניות תוכנית התצוגה החזותית של Google

    מהי מדיניות התוכנית של Google להצגה חזותית?
    כפי שמתואר בתנאים ובהגבלות , אנחנו עשויים לסרב לכלול ולהציג תוכן שמפר את מדיניות התוכנית שלנו על ידי הצגה או קישור אל:
    • תוכן בלתי חוקי.
    • חדירה לפרטיות אישית.
    • פורנוגרפיה או גסויות.
    • תוכן, כמו קוד זדוני, שמפריע למחשב של המשתמש או לתפקוד של דף האינטרנט של המארח, או מזיק לו,
    • עידוד שנאה או הסתה לאלימות.
    • הפרות של זכויות יוצרים. למידע נוסף, עיין במדיניות DMCA‏ שלנו.
    • הפרות של סימנים מסחריים.
    • התחזות לגורמי צד שלישי.

    מפתחים שיוצרים תרשימים שאוספים נתונים, מסכימים לתחזק מדיניות פרטיות בעלת תוקף משפטי ולקשר אותה. בנוסף, אנחנו דורשים מהמפתחים לוודא שהתרשים שלהם מאובטח ולשמור על היישום שלהם כל עוד הוא נמצא בספריית התרשימים.

    מדיניות זו עשויה להשתנות מעת לעת ללא הודעה מוקדמת.

    האם ממשק ה-API של Google Visualization זמין לשימוש מסחרי?
    כן. באותיות הקטנות, יש לעיין בתנאים ובהגבלות של Google Visualization API.
    האם אפשר להשתמש ב-Google Visualization API כדי ליצור תוכנה בצד הלקוח?
    בשלב זה, אנחנו לא מאפשרים למפתחים להשתמש ב-Vision API כדי ליצור תוכנות בצד הלקוח. ניתן להשתמש בממשק ה-API להצגה רק באמצעות הממשק שסופק. באותיות הקטנות, יש לעיין בתנאים ובהגבלות של Google Visualization API.
    האם Google מתעדת את כל נתוני התרשים?
    נתוני התרשים הכלולים בבקשת ה-HTTP נשמרים ביומנים זמניים, למשך לא יותר משבועיים למטרות בדיקה פנימית וניפוי באגים. ברור שאם התרשים מופיע בתג תמונה בדף אינטרנט ציבורי, ייתכן שהוא ייסרק.
    הפרה של מדיניות התוכנית.
    הפרות של תקנון התוכנית הזה עלולות לגרום להשבתה או להסרה של התרשים, וכדי למנוע ממנו העלאה של תרשימים עתידיים, לסגירת חשבונות Google ו/או למחיקת כל התרשימים שלך.

    להפוך לפעילים בקהילה

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