דף זה תורגם על ידי Cloud Translation API.

שאלות נפוצות

תחילת העבודה
באמצעות ה-API
פתרון בעיות
המדיניות של GoogleVisual API
להיות פעילים בקהילה

תחילת העבודה

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

שימוש ב-API

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

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

באמצעות Vision API אפשר לחבר תרשימים ומקורות נתונים באינטרנט ולפרסם אותם:

ה-Visual API מספק API של JavaScript לגישה לתרשימים.
גלריית התרשימים שלו כוללת תרשימים שנוצרו על ידי Google, אבל היא פתוחה גם לכל צד שלישי לצורך יצירת המחשות חזותיות משלו התואמות ל-Visual API.
תרשימים ותרשימים ב-Visual API יכולים להיות כל דבר שניתן לעבד באמצעות דפדפן. ההנחיה הזו כוללת תמונות, JavaScript, גרפיקה וקטורית, Flash וכו'.
באמצעות ה-Visual API אפשר לגשת למספר גדול של תרשימים ב-Chart API, אבל יכול להיות שחלק מאפשרויות ההגדרה לא יהיו זמינות.
ה-API מספק גם פרוטוקול חוטים מתועד ודרך שבה כל אחד יכול לחשוף את מקורות הנתונים שלו לכל אחת מהתצוגות החזותיות של ממשקי ה-API.
ל-API יש מודל אירועים מוגדר שמאפשר לתרשימים להציג ולקבל אירועים, וכך לתקשר עם הדף המארח ו/או עם תרשימים אחרים בדף.

לאילו מקורות נתונים אפשר לגשת באמצעות ה-Visual API?

בעזרת ה-Visual API אפשר לגשת לנתונים באופן מקומי מהדפדפן על-ידי יצירת פורמט DataTable סטנדרטי של ה-API, או גישה לכל מקור נתונים שתומך ב-API. האפליקציות המוכרות שכבר תומכות ב-API הן Google Sheets ו-Salesforce.com בפלטפורמת המפתחים של Force.com. אפשר גם להטמיע נתונים משלכם כמקור נתונים של תרשים.

האפליקציה שלי מצפה שהנתונים שהיא מקבלת יהיו בפורמט ספציפי. איך מטפלים בחריגים?

אתם יכולים להשתמש בשיטות getNumberOfColumns() ו-getColumnType() בכיתה google.visualization.DataTable כדי לבדוק שהנתונים שיתקבלו תואמים לציפיות שלכם, ולשלוח הודעת שגיאה על אי-התאמות.

האם בטוח להטמיע תרשים באתר שלי?

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

אפשר להשתמש בתרשימים במצב אופליין?

למחשבים של המשתמשים שלך צריכה להיות גישה אל https://www.gstatic.com/charts/loader.js כדי להשתמש בתכונות האינטראקטיביות של Google Charts. הסיבה לכך היא שספריות התצוגה החזותיות שנדרשות לדף נטענות באופן דינמי לפני שמשתמשים בהן. הקוד לטעינת הספרייה המתאימה הוא חלק מהסקריפט הכלול, והוא מופעל כשמפעילים את ה-method google.charts.load(). התנאים וההגבלות שלנו לא מאפשרים להוריד את הקוד google.charts.load או google.visualization לשימוש במצב אופליין.

האם ניתן להוריד ולארח את קוד התרשים באופן מקומי או ברשת אינטראנט?

מצטערים, התנאים וההגבלות שלנו לא מאפשרים להוריד ולשמור או לארח את הקוד google.charts.load או google.visualization. עם זאת, אם לא נדרשת לך האינטראקטיביות של Google Charts, אפשר פשוט לצלם את התרשימים ולהשתמש בהם לפי הצורך.

פתרון בעיות

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

דבר ראשון, צריך לבדוק את לוח JavaScript. ב-Chrome, ניתן לגשת ללוח JavaScript דרך Chrome->View->Developer->JavaScript Console, או דרך Chrome->כלים->לוח JavaScript. לכל הדפדפנים המודרניים יש לוח JavaScript. יכול להיות שתצטרכו לעיין בתפריטים עם שמות כמו 'מתקדם' או 'כלים למפתחים' כדי למצוא אותו.

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

ייתכן שאתם משתמשים ב-Google Loader בצורה שגויה.

צריך לטעון את התרשימים/loader.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 היא שפה תלוית אותיות רישיות.

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

למה הימים והחודשים שלי בפיגור אחד?

Google Charts משתמש ב-JavaScript, המשתמש באינדקס שמתחיל בספרה אפס. היום הראשון בחודש הוא 0, וטווח החודשים הוא בין 0 (ינואר) ל-11 (דצמבר). אם הקוד מבוסס על ההנחה שיצירת אינדקס שמבוססת על יחידה אחת, צריך להחסיר 1 לפני הזנת הנתונים באובייקט תאריך של JavaScript.

למה התרשימים פועלים בדפדפנים מסוימים אבל לא בכולם?

אנחנו ממליצים על caniuse.com כדי לקבל המון מידע על חוסר תאימות של דפדפנים. ב-Google Charts לפעמים יש בעיות ב-Internet Explorer 8 ובגרסאות קודמות, בגלל שתי סיבות:

IE8 לא תומך ב-SVG, ולכן Charts נכשל מעבר ל-VML, שהוא מוגבל יותר.

ה-JavaScript של IE8 אינו מתיר פסיקים בסוף ברשימות.

מדוע התרשים מבוסס ה-Flash שלי לא מופיע כאשר אני בודק אותו?

בגלל הגדרות האבטחה של Flash, ייתכן שתרשימים מבוססי Flash לא יפעלו כראוי כשניגשים אליהם ממיקום של קובץ בדפדפן (לדוגמה, file:///c:/webhost/myhost/myviz.html) ולא מכתובת URL של שרת אינטרנט (למשל http://www.myhost.com/myviz.html). בדרך כלל מדובר בבעיה לבדיקה בלבד. הבעיה אינה בעיה כשניגשים לתרשים מכתובת http:// . אפשר להתגבר על הבעיה הזו כמו שמתואר באתר האינטרנט של Macromedia. באופן כללי, מומלץ להימנע מפיתוח Flash, ככל האפשר.

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

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

כפי שמתואר בתנאים ובהגבלות, אנחנו עשויים לדחות בקשה לכלול תוכן שמפר את מדיניות התוכנית שלנו ולהציג תוכן כזה, על ידי הצגת התוכן הבא או הקישור אליו:

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

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

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

האם Google Vision API זמין לשימוש מסחרי?

כן. האותיות הקטנות מפורטות בתנאים ובהגבלות של GoogleVisual API.

האם אפשר להשתמש ב-GoogleVisual API כדי ליצור תוכנה בצד הלקוח?

כרגע אנחנו לא מאפשרים למפתחים להשתמש ב-Visual API כדי ליצור תוכנה בצד הלקוח. אפשר להשתמש ב-Visual API רק דרך הממשק. לאותיות הקטנות, קראו את התנאים וההגבלות של GoogleVisual API.

האם Google רושמת ביומן את כל נתוני התרשים שלי?

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

הפרות של מדיניות התוכנית.

הפרות של מדיניות התוכנית הזו עלולות להוביל להשבתה או להסרה של התרשים, לחסימה שלך ולא ניתן יהיה להעלות תרשימים בעתיד, לסגור את חשבונות Google שלך ו/או למחוק את כל התרשימים שלך.

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

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