الأسئلة الشائعة

البدء

ما المقصود بواجهة برمجة تطبيقات الرسوم المرئية في Google؟
تتيح لك "واجهة برمجة التطبيقات للتمثيل البصري من Google" إنشاء رسوم بيانية وتطبيقات لإعداد تقارير باستخدام البيانات المنظَّمة، كما تساعد على دمجها مباشرةً في موقعك الإلكتروني.
ما الذي يمكنني فعله باستخدام واجهة برمجة التطبيقات المرئية؟
باستخدام واجهة برمجة التطبيقات للمرئيات من Google، يمكنك الوصول إلى البيانات المنظَّمة التي تم إنشاؤها محليًا في المتصفّح أو استردادها من مصادر البيانات المتوافقة بتنسيق جدولي بسيط. يمكنك أيضًا تنفيذ مصدر بياناتك الخاص باعتباره مصدر بيانات "واجهة برمجة التطبيقات للتمثيل البصري" وتفعيل أي تطبيق مرئي و/أو تطبيق متوافق مع التمثيل البصري للوصول إلى بياناتك. هذا التنسيق قابل للاستخدام من خلال تطبيقات إعداد التقارير أو التحليل أو الرسم البياني. ومن ثم، يمكنك تصور البيانات و/أو إضافة وظائف جديدة إلى التطبيقات، مثل "جداول بيانات Google".
أين يمكنني العثور على وثائق لواجهة برمجة تطبيقات التمثيل البصري؟
يمكنك الاطّلاع على دليل المطوّر وجميع المستندات الأخرى ذات الصلة على https://developers.google.com/chart/interactive/docs.
كيف يمكنني إنشاء رسم بياني جديد؟
أفضل طريقة للبدء هي قراءة المقدمة وقسم البدء السريع.
ما المقصود بعنوان URL لمصدر البيانات؟
عنوان URL لمصدر البيانات هو معرّف عنوان URL الفريد لمصدر بيانات واجهة برمجة التطبيقات المرئية. وقد يتضمّن عنوان URL لمصدر البيانات أيضًا مَعلمات لغة طلب البحث في الرسم البياني. وفي هذه الحالة، يتم تنفيذ طلب بحث (مثل التصنيف والتصنيف وما إلى ذلك) في مصدر البيانات قبل جلب البيانات.
أين يمكنني العثور على مثال لرمز تطبيقات الرسوم البيانية باستخدام واجهة برمجة التطبيقات المرئية؟
يمكنك العثور على مثال للرمز في وثائق مثال على رمز واجهة برمجة التطبيقات في "التمثيل البصري".
هل يمكن لتطبيق Flash الدخول إلى واجهة برمجة التطبيقات المرئية؟
بالتأكيد. تستخدم واجهة برمجة التطبيقات التمثيل البصري واجهة برمجة تطبيقات JavaScript، ولكن هناك مكتبات تمكّن تطبيقات Flash من الاتصال برمز JavaScript. يمكنك العثور على إحدى هذه المكتبات المفيدة على http://code.google.com/p/swfobject. انظر أدناه للتعرف على بعض مشكلات التطوير التي تؤثر في Flash.
كيف يمكنني تنفيذ مصدر بيانات؟
يمكنك الاطّلاع على القسم الذي يتناول استخدام رسم بياني وإنشاؤه، للتعرّف على آلية عمل الرسوم البيانية، ثم قراءة تطبيق مصدر بيانات لمعرفة كيفية إنشاء مصدر بيانات. يمكنك أيضًا استخدام مكتبة جافا لمصدر بيانات الرسم البياني من Google للبدء بسرعة في حال استخدام جافا.
هل يمكنني الدخول إلى مخطط من تطبيق جافا؟
نعم. تتيح لك مكتبة التمثيل البصري من Google لمجموعة أدوات الويب من Google الوصول إلى التمثيلات البصرية المتوافقة مع واجهة برمجة التطبيقات من رمز جافا المجمّع باستخدام محول GWT وكتابة التصورات المتوافقة مع التمثيل البصري لواجهة برمجة التطبيقات في جافا باستخدام محول GWT. تدعم مكتبة العناصر المرشحة للإصدار أيضًا نموذج حدث واجهة برمجة التطبيقات للتمثيل البصري.
هل يمكنني الدخول إلى مخطط من تطبيق مكتوب باستخدام برنامج التجميع في Google Web Toolkit (GWT)؟
نعم. تتيح لك مكتبة التمثيل البصري من Google لمجموعة أدوات الويب من Google الوصول إلى التمثيلات البصرية المتوافقة مع واجهة برمجة التطبيقات من رمز جافا المجمّع باستخدام محول GWT وكتابة التصورات المتوافقة مع التمثيل البصري لواجهة برمجة التطبيقات في جافا باستخدام محول GWT. تدعم مكتبة العناصر المرشحة للإصدار أيضًا نموذج حدث واجهة برمجة التطبيقات للتمثيل البصري.
لدي سؤال/مشكلة مختلفة، من الذي ينبغي الاتصال به للحصول على المزيد من المعلومات؟
يُرجى نشر سؤالك في مجموعة مناقشة واجهة برمجة تطبيقات Google المرئية للحصول على مساعدة من منتدى مطوري "التمثيل البصري". ويشارك فريق التمثيل البصري في Google أيضًا في هذه المجموعة للإجابة عن الأسئلة.

استخدام واجهة برمجة التطبيقات

ما الفرق بين واجهة برمجة التطبيقات للرسم البياني من Google وواجهة برمجة التطبيقات للتمثيل البصري من Google؟

توفّر واجهة برمجة التطبيقات للرسم البياني طريقة بسيطة لإنشاء مخططات صور بمختلف أنواعها من خلال إرسال عنوان URL منسّق يتضمّن خيارات ضبط البيانات والرسم البياني إلى خادم Google. تتضمن واجهة برمجة التطبيقات للرسم البياني مجموعة مغلقة من الرسومات البيانية مع خيارات متعددة. تقتصر مجموعات بيانات واجهة برمجة التطبيقات للرسم البياني على حجم عنوان URL (2 كيلوبايت تقريبًا).

توفّر "واجهة برمجة التطبيقات للتمثيل البصري" طريقة لربط الرسوم البيانية ومصادر البيانات على الويب ونشرها:

  • توفر واجهة برمجة التطبيقات التمثيل البصري واجهة برمجة تطبيقات جافا سكريبت للدخول إلى الرسوم البيانية.
  • ويتضمن معرض الرسوم البيانية التابع لها مخططات تم إنشاؤها من قِبل Google، ولكنه متاح أيضًا لأي طرف ثالث لإنشاء التمثيلات البصرية المتوافقة مع واجهة برمجة التطبيقات.
  • يمكن أن تكون الرسوم البيانية لواجهة برمجة التطبيقات والمخططات المرئية أي شيء يمكن عرضه من خلال المتصفح. ويتضمن ذلك الصور وجافا سكريبت والرسومات الموجّهة والفلاش وغير ذلك.
  • يمكن الوصول إلى عدد كبير من الرسوم البيانية لواجهة برمجة التطبيقات من خلال الرسوم البيانية في واجهة برمجة التطبيقات، على الرغم من أن بعض خيارات الضبط قد لا تكون متاحة.
  • توفّر واجهة برمجة التطبيقات أيضًا بروتوكول سلك موثَّقًا وطريقة يمكن لأي شخص من خلالها عرض مصادر بياناته لأي من العروض المرئية في واجهات برمجة التطبيقات.
  • لدى واجهة برمجة التطبيقات نموذج حدث محدد يسمح بالمخططات لرمي الأحداث وتلقيها وبالتالي الاتصال بصفحة المضيف و/أو المخططات الأخرى على الصفحة.
ما مصادر البيانات التي يمكنني الدخول إليها باستخدام واجهة برمجة التطبيقات المرئية؟
باستخدام واجهة برمجة التطبيقات للتمثيل المرئي، يمكنك الوصول إلى البيانات محليًا من المتصفّح من خلال إنشاء تنسيق DataTable عادي لواجهة برمجة التطبيقات أو الوصول إلى أي مصدر بيانات يتوافق مع واجهة برمجة التطبيقات. من بين التطبيقات الشهيرة المتوافقة مع واجهة برمجة التطبيقات جداول بيانات Google وSalesforce.com على منصّة مطوّري البرامج على Force.com. يمكنك أيضًا تنفيذ بياناتك الخاصة كمصدر بيانات "الرسم البياني".
يتوقع تطبيقي أن تكون البيانات التي يتلقاها بتنسيق محدد. كيف أتعامل مع الاستثناءات؟
يمكنك استخدام الطريقتين (getNumberOfColumns()) وgetColumnType() (الفئة) google.visualization.DataTable لاختبار تطابق البيانات التي تحصل عليها مع ما تتوقّعه، وإرسال رسالة خطأ لعدم تطابق البيانات.
هل من الآمن تضمين مخطط في موقعي على الويب؟
ينطوي تشغيل رمز الجهة الخارجية مباشرةً على موقعك الإلكتروني على مخاطر كامنة. لا تقدم Google أي وعود أو بيانات عن أداء التطبيق أو جودته أو أمانه أو محتواه. قد تتم إزالة تطبيقات الرسم البياني التي لا تلتزم ببنود الخدمة الخاصة بواجهة برمجة تطبيقات الرسوم المرئية في Google من المعارض.
هل يمكنني استخدام الرسوم البيانية بلا اتصال؟
يجب أن تمتلك أجهزة كمبيوتر المستخدمين إمكانية الوصول إلى https://www.gstatic.com/charts/loader.js لاستخدام الميزات التفاعلية في "مخططات Google". ويرجع ذلك إلى أنه يتم تحميل مكتبات التمثيل البصري التي تتطلّبها صفحتك بشكل ديناميكي قبل استخدامها. ويكون رمز تحميل المكتبة المناسبة جزءًا من النص البرمجي المضمَّن ويتم استدعاؤه عند استدعاء طريقة google.charts.load(). لا تسمح لك بنود الخدمة بتنزيل الرمز google.charts.load أو google.visualization لاستخدامه بلا اتصال بالإنترنت.
هل يمكنني تنزيل شفرة الرسم البياني واستضافتها محليًا أو على شبكة داخلية؟
عذرًا، لا تسمح لك بنود الخدمة بتنزيل الرمز google.charts.load أو google.visualization وحفظه أو استضافته. ومع ذلك، إذا لم تكن بحاجة إلى التفاعل مع "مخطَّطات Google"، يمكنك أخذ لقطة شاشة للرسم البياني واستخدامها كما تشاء.

تحديد المشاكل وحلّها

لماذا لا يظهر الرسم البياني؟

أولاً، تحقق من وحدة تحكم جافا سكريبت. في Chrome، يمكنك الدخول إلى وحدة تحكم جافا سكريبت عبر Chrome-> عرض-> مطور البرامج-> وحدة تحكم جافا سكريبت، أو Chrome-> أدوات-> وحدة تحكم جافا سكريبت. تحتوي جميع المتصفحات الحديثة على وحدة تحكم جافا سكريبت؛ قد تحتاج إلى البحث في القوائم التي تحمل أسماء مثل "متقدمة" أو "أدوات مطوري البرامج" للعثور عليها.

نأمل أن تنقلك وحدة التحكم إلى المشكلة فورًا. إلا أنه قد يصعب أحيانًا ترجمة رسالة وحدة التحكم إلى السبب الكامن وراء ذلك. في ما يلي بعض المخاطر الشائعة:

  • ربما تستخدم برنامج تحميل Google بشكل غير صحيح.
    • يمكنك تحميل الرسوم البيانية/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 في المثال أعلاه).
  • ابحث عن الأخطاء الإملائية. تذكر أن جافا سكريبت هي لغة حساسة لحالة الأحرف.

إذا كنت لا تزال في حيرةٍ من أمرك، فابحث في مجموعة مناقشة واجهة برمجة التطبيقات المرئية في Google لمعرفة ما إذا كان هناك أي شخص واجه مشكلة مماثلة. إذا لم تتمكن من العثور على مشاركة تجيب عن سؤالك، فأرسل سؤالك إلى المجموعة مع رابط إلى صفحة ويب توضح المشكلة. إن أمكن، يمكنك تضمين jsfiddle.

لماذا تتأخر الشهور والأيام عن شهر واحد؟
تستخدم "مُخطَّطات Google" JavaScript التي لا تستخدم أي فهرسة. اليوم الأول من الشهر هو 0، وتتراوح الأشهر بين 0 (كانون الثاني (يناير)) و11 (كانون الأول (ديسمبر)). إذا كان الرمز يفترض الفهرسة المستندة إلى واحد، اطرح إحدى القيم قبل وضع البيانات في كائن تاريخ JavaScript.
لماذا تعمل الرسوم البيانية في بعض المتصفحات وليس كلها؟
نوصي باستخدام caniuse.com للحصول على كنز من المعلومات حول عدم توافق المتصفّحات. في "مخططات Google"، هناك أحيانًا مشاكل في الإصدار 8 من Internet Explorer والإصدارات الأقدم، وذلك لسببين:
  • لا يتوافق IE8 مع تنسيق SVG، لذلك يتعذّر استخدام الرسوم البيانية في VML، ما يجعلها محدودة.
  • لا يسمح جافا سكريبت لـ IE8 باستخدام الفواصل اللاحقة في القوائم.
    • لماذا لا يظهر الرسم البياني المستند إلى فلاش عند اختباره؟
    بسبب إعدادات أمان Flash، قد لا تعمل المخططات المستندة إلى فلاش بشكل صحيح عند الدخول إليها من موقع ملف في المتصفح (على سبيل المثال، file:///c:/webhost/myhost/myviz.html) بدلاً من عنوان URL لخادم الويب (على سبيل المثال، http://www.myhost.com/myviz.html). وتُعدّ هذه عادةً مشكلة في الاختبار فقط، وليست مشكلة عند الوصول إلى الرسم البياني من عنوان http:// . ويمكنك حلّ هذه المشكلة كما هو موضّح في موقع Macromedia الإلكتروني. نوصي على وجه العموم بتجنب تطوير Flash كلما أمكن.

    سياسة برنامج التمثيل البصري في Google

    ما المقصود بسياسة برنامج التمثيل البصري في Google؟
    كما هو موضّح في بنود الخدمة، يجوز لنا رفض تضمين أو عرض محتوى يخالف سياسة البرنامج من خلال عرض أو الربط بما يلي:
    • المحتوى غير القانوني.
    • انتهاك الخصوصية الشخصية
    • المواد الإباحية أو الفاحشة.
    • محتوى - مثل الشفرة الضارة - يتداخل مع جهاز كمبيوتر المستخدم أو يؤثر في عمل صفحة الويب المضيفة أو يضر بها.
    • الترويج للكراهية أو التحريض على العنف.
    • انتهاكات حقوق الطبع والنشر. يُرجى الاطلاع على سياسة قانون الألفية الجديدة لحقوق طبع ونشر المواد الرقمية لمزيد من المعلومات.
    • انتهاكات العلامة التجارية.
    • عمليات انتحال هوية جهات خارجية.

    ويوافق مطوّرو البرامج الذين ينشئون رسومًا بيانية على جمع البيانات، ويحافظون على سياسة خصوصية ملائمة قانونيًا وترتبط بها. بالإضافة إلى ذلك، نطلب من مطوّري البرامج التأكد من أمان الرسم البياني والحفاظ على التطبيق ما دام موجودًا في دليل الرسوم البيانية.

    ويمكن مراجعة هذه السياسات من حين لآخر بدون إشعار.

    هل واجهة برمجة تطبيقات الرسوم المرئية في Google متاحة للاستخدام التجاري؟
    نعم. للتعرُّف على التفاصيل، يُرجى الرجوع إلى بنود الخدمة في Google Visualization API.
    هل يمكنني استخدام واجهة برمجة تطبيقات الرسوم المرئية في Google لإنشاء برامج من جهة العميل؟
    لا نسمح لمطوّري البرامج في الوقت الحالي باستخدام واجهة برمجة التطبيقات المرئية لإنشاء برامج من جهة العميل. ويجوز لك فقط استخدام واجهة برمجة التطبيقات المرئية من خلال الواجهة المتوفرة. للتعرُّف على التفاصيل، يُرجى الرجوع إلى بنود خدمة واجهة برمجة التطبيقات في Google المرئية.
    هل يسجل Google جميع بيانات المخطط؟
    يتم حفظ بيانات الرسم البياني المضمّنة في طلب HTTP في السجلات المؤقتة لمدة لا تزيد عن أسبوعين لأغراض الاختبار الداخلي وتصحيح الأخطاء. وبالطبع، يجب أن تفهم أنه إذا كان الرسم البياني يظهر في علامة صورة على صفحة ويب علنية، يمكن الزحف إليه.
    انتهاكات سياسات البرنامج.
    قد تؤدي أي مخالفة لسياسات البرنامج هذه إلى إيقاف الرسم البياني أو إزالته، وإدراجه في القائمة السوداء لمنعه من تحميل الرسوم البيانية المستقبلية، و/أو إنهاء حسابات Google و/أو حذف جميع الرسوم البيانية.

    النشاط في المنتدى

    كيف يمكنني مشاركة تطبيق الرسم البياني مع الآخرين؟
    يمكنك البدء بوضع الرسم البياني في معرض الرسوم البيانية. يمكنك الربط مرة أخرى بموقعك وتوفير شفرة المصدر إذا رغبت في ذلك. شارك في مجموعة المناقشة للحصول على تعليقات المنتدى.
    معرض الرسوم البيانية هو قائمة بالتطبيقات التي تستخدم واجهة برمجة التطبيقات المرئية. ويوفر موقعًا مركزيًا لمنتدى مطوري التمثيل البصري لمشاركة تطبيقات الرسم البياني. لإرسال تطبيق الرسم البياني إلى المعرض، يمكنك تقديم طلب على الإنترنت.
    كيف يمكنني الترويج لمصدر بيانات الرسم البياني؟
    انشر التنفيذ على مجموعة التمثيل البصري. وإذا أعجبنا، قد نذكره بنفسنا.