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

البدء

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

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

ما الفرق بين Google Chart API وGoogle Visualization API؟

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

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

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

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

لماذا لا يظهر مخططي؟

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

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

  • من المحتمل أنّك تستخدم Google Loader بشكل غير صحيح.
    • لا تحمِّل سوى schema/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 لغة حساسة لحالة الأحرف.

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

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

    سياسة برنامج مؤثرات عرض Google

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

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

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

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

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

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