अक्सर पूछे जाने वाले प्रश्न

शुरू करें

Google विज़ुअलाइज़ेशन API क्या है?
Google विज़ुअलाइज़ेशन एपीआई की मदद से, स्ट्रक्चर्ड डेटा का इस्तेमाल करके चार्ट और रिपोर्टिंग ऐप्लिकेशन बनाए जा सकते हैं. साथ ही, इन्हें सीधे आपकी वेबसाइट में इंटिग्रेट करने में मदद मिलती है.
विज़ुअलाइज़ेशन एपीआई की मदद से क्या किया जा सकता है?
Google विज़ुअलाइज़ेशन एपीआई की मदद से, आपके पास ब्राउज़र पर स्थानीय तौर पर बनाया गया स्ट्रक्चर्ड डेटा ऐक्सेस करने का विकल्प होता है. इसके अलावा, इसे इस्तेमाल किए जा सकने वाले डेटा सोर्स से आसान टेबल फ़ॉर्मैट में, हासिल किया जा सकता है. अपने डेटा सोर्स को विज़ुअलाइज़ेशन एपीआई डेटा सोर्स के तौर पर भी लागू किया जा सकता है. साथ ही, अपना डेटा ऐक्सेस करने के लिए, विज़ुअलाइज़ेशन का पालन करने वाले विज़ुअलाइज़ेशन और/या ऐप्लिकेशन को चालू किया जा सकता है. इस फ़ॉर्मैट को रिपोर्ट, विश्लेषण या चार्ट ऐप्लिकेशन में इस्तेमाल करने की अनुमति है. इसलिए, डेटा को विज़ुअलाइज़ किया जा सकता है और/या ऐप्लिकेशन में नई सुविधाएं जोड़ी जा सकती हैं, जैसे कि Google स्प्रेडशीट.
मुझे विज़ुअलाइज़ेशन एपीआई के लिए दस्तावेज़ कहां मिल सकते हैं?
डेवलपर गाइड और अन्य सभी दस्तावेज़, https://developers.google.com/chart/interactive/docs पर देखे जा सकते हैं.
मैं नया चार्ट कैसे बनाऊं?
शुरुआत करने का सबसे अच्छा तरीका है कि आप शुरुआती जानकारी और क्विकस्टार्ट सेक्शन पढ़ें.
डेटा सोर्स यूआरएल क्या है?
डेटा सोर्स का यूआरएल, विज़ुअलाइज़ेशन एपीआई के डेटा सोर्स का यूनीक यूआरएल आइडेंटिफ़ायर होता है. डेटा सोर्स के यूआरएल में, चार्ट की क्वेरी की भाषा के पैरामीटर भी शामिल किए जा सकते हैं. इस मामले में, डेटा फ़ेच करने से पहले डेटा सोर्स पर क्वेरी (जैसे कि क्रम से लगाना, ग्रुप करना वगैरह) की जाती है.
विज़ुअलाइज़ेशन एपीआई का इस्तेमाल करके, मुझे चार्ट ऐप्लिकेशन के उदाहरण कोड कहां मिल सकते हैं?
विज़ुअलाइज़ेशन एपीआई के उदाहरण कोड दस्तावेज़ में, कोड का उदाहरण दिया गया है.
क्या कोई फ़्लैश ऐप्लिकेशन विज़ुअलाइज़ेशन API को ऐक्सेस कर सकता है?
बिलकुल. विज़ुअलाइज़ेशन एपीआई एक JavaScript API का इस्तेमाल करता है, लेकिन कुछ लाइब्रेरी ऐसी हैं जो फ़्लैश ऐप्लिकेशन को JavaScript कोड से कनेक्ट करने की सुविधा देती हैं. ऐसी ही एक लाइब्रेरी आपको काम की लग सकती है. आप http://code.google.com/p/swfobject पर जा सकते हैं. Flash को प्रभावित करने वाली कुछ डेवलपमेंट समस्याओं के लिए नीचे देखें.
मैं डेटा सोर्स कैसे लागू करूं?
चार्ट के काम करने का तरीका जानने के लिए, चार्ट का इस्तेमाल करने और उसे बनाने से जुड़ा सेक्शन पढ़ें. इसके बाद, डेटा सोर्स बनाने का तरीका जानने के लिए, डेटा सोर्स लागू करना लेख पढ़ें. Java का इस्तेमाल करने पर, Google चार्ट के डेटा सोर्स की Java लाइब्रेरी का इस्तेमाल तुरंत शुरू करने के लिए भी किया जा सकता है.
क्या Java ऐप्लिकेशन से चार्ट को ऐक्सेस किया जा सकता है?
हां. Google Web Toolkit (GWT) की Google विज़ुअलाइज़ेशन लाइब्रेरी से, आपको GWT कंपाइलर के साथ कंपाइल किए गए Java कोड से एपीआई के मुताबिक विज़ुअलाइज़ेशन ऐक्सेस करने की सुविधा मिलती है. साथ ही, GWT कंप्लायर का इस्तेमाल करके, Java में विज़ुअलाइज़ेशन एपीआई के नियमों का पालन करने वाले विज़ुअलाइज़ेशन भी लिखे जा सकते हैं. रिलीज़ कैंडिडेट लाइब्रेरी, विज़ुअलाइज़ेशन एपीआई इवेंट मॉडल के साथ भी काम करती है.
क्या मैं Google Web Toolkit (GWT) कंपाइलर के साथ लिखे गए किसी ऐप्लिकेशन से चार्ट को ऐक्सेस कर सकता/सकती हूं?
हां. Google Web Toolkit (GWT) की Google विज़ुअलाइज़ेशन लाइब्रेरी से, आपको GWT कंपाइलर के साथ कंपाइल किए गए Java कोड से एपीआई के मुताबिक विज़ुअलाइज़ेशन ऐक्सेस करने की सुविधा मिलती है. साथ ही, GWT कंप्लायर का इस्तेमाल करके, Java में विज़ुअलाइज़ेशन एपीआई के नियमों का पालन करने वाले विज़ुअलाइज़ेशन भी लिखे जा सकते हैं. रिलीज़ कैंडिडेट लाइब्रेरी, विज़ुअलाइज़ेशन एपीआई इवेंट मॉडल के साथ भी काम करती है.
मेरा एक अलग सवाल/समस्या है. ज़्यादा जानकारी पाने के लिए मैं किससे संपर्क करूं?
कृपया विज़ुअलाइज़ेशन डेवलपर समुदाय से मदद पाने के लिए, अपना सवाल Google विज़ुअलाइज़ेशन API चर्चा ग्रुप में पोस्ट करें. सवालों के जवाब देने के लिए, Google विज़ुअलाइज़ेशन टीम भी इस ग्रुप में हिस्सा लेती है.

एपीआई का इस्तेमाल करना

Google Chart API और Google विज़ुअलाइज़ेशन एपीआई में क्या अंतर है?

Chart API किसी Google सर्वर को डेटा और चार्ट कॉन्फ़िगरेशन, दोनों वाले फ़ॉर्मैट वाले यूआरएल भेजकर अलग-अलग तरह के इमेज चार्ट बनाने का एक आसान तरीका उपलब्ध कराता है. Chart API में कई विकल्पों वाले चार्ट का एक सेट शामिल होता है. Chart API के डेटासेट यूआरएल के साइज़ (करीब 2K) तक सीमित होते हैं.

विज़ुअलाइज़ेशन एपीआई, चार्ट और डेटा सोर्स को वेब पर जोड़ने और उन्हें पब्लिश करने का तरीका देता है:

  • विज़ुअलाइज़ेशन एपीआई, चार्ट ऐक्सेस करने के लिए JavaScript API की सुविधा देता है.
  • इसके चार्ट की गैलरी में Google के बनाए गए चार्ट शामिल हैं, लेकिन यह किसी भी तीसरे पक्ष के लिए उपलब्ध है, ताकि वह विज़ुअलाइज़ेशन एपीआई के हिसाब से विज़ुअलाइज़ेशन बना सके.
  • विज़ुअलाइज़ेशन एपीआई चार्ट और चार्ट कुछ भी हो सकते हैं, जिन्हें ब्राउज़र से रेंडर किया जा सकता है. इसमें चित्र, JavaScript, वेक्टर-ग्राफ़िक, फ़्लैश वगैरह शामिल हैं.
  • विज़ुअलाइज़ेशन एपीआई की मदद से, Chart API के कई चार्ट ऐक्सेस किए जा सकते हैं. हालांकि, हो सकता है कि उनके कुछ कॉन्फ़िगरेशन विकल्प उपलब्ध न हों.
  • यह एपीआई, वायर प्रोटोकॉल का दस्तावेज़ भी उपलब्ध कराता है. साथ ही, यह किसी को भी अपने डेटा सोर्स को किसी भी एपीआई विज़ुअलाइज़ेशन में दिखाने का तरीका मुहैया कराता है.
  • एपीआई में एक पहले से तय इवेंट मॉडल मौजूद है. इसकी मदद से चार्ट, इवेंट की जानकारी फेंक सकते हैं और पा सकते हैं. इस तरह, चार्ट अपने होस्ट पेज और/या पेज पर मौजूद अन्य चार्ट के साथ जानकारी शेयर कर सकते हैं.
विज़ुअलाइज़ेशन एपीआई का इस्तेमाल करके, कौनसे डेटा सोर्स ऐक्सेस किए जा सकते हैं?
विज़ुअलाइज़ेशन एपीआई की मदद से, अपने ब्राउज़र से स्थानीय तौर पर डेटा ऐक्सेस किया जा सकता है. इसके लिए, आपको एपीआई का स्टैंडर्ड DataTable फ़ॉर्मैट बनाना होगा या एपीआई के साथ काम करने वाले किसी भी डेटा सोर्स को ऐक्सेस करना होगा. Google स्प्रेडशीट, और Salesforce.com के लिए, इनके Force.com डेवलपर प्लैटफ़ॉर्म का इस्तेमाल किया जाता है. ये ऐसे ऐप्लिकेशन होते हैं जो पहले से ही एपीआई के साथ काम करते हैं. अपने डेटा को, चार्ट के डेटा सोर्स के तौर पर भी लागू किया जा सकता है.
मेरे ऐप्लिकेशन को मिलने वाला डेटा एक खास फ़ॉर्मैट में होना चाहिए. मैं अपवादों को कैसे मैनेज करूं?
यह जांच करने के लिए कि आपको जो डेटा मिल रहा है वह आपकी उम्मीद के मुताबिक है या नहीं, क्लास google.visualization.DataTable के getNumberOfColumns() और getColumnType() मेथड का इस्तेमाल करें. साथ ही, डेटा के मेल न खाने पर गड़बड़ी का मैसेज जारी किया जा सकता है.
क्या मेरी वेब साइट में चार्ट एम्बेड करना सुरक्षित है?
अपनी वेबसाइट पर, तीसरे पक्ष का कोड इस्तेमाल करने से कुछ जोखिम हो सकते हैं. Google, ऐप्लिकेशन की परफ़ॉर्मेंस, क्वालिटी, सुरक्षा या कॉन्टेंट के बारे में कोई वादा नहीं करता और न ही इसका प्रतिनिधित्व करता है. Google विज़ुअलाइज़ेशन एपीआई की सेवा की शर्तों का पालन नहीं करने वाले चार्ट ऐप्लिकेशन को गैलरी से हटाया जा सकता है.
क्या चार्ट को ऑफ़लाइन इस्तेमाल किया जा सकता है?
Google चार्ट की इंटरैक्टिव सुविधाओं का इस्तेमाल करने के लिए आपके उपयोगकर्ताओं के कंप्यूटर के पास https://www.gstatic.com/charts/loader.js का ऐक्सेस होना चाहिए. इसकी वजह यह है कि आपके पेज के लिए ज़रूरी विज़ुअलाइज़ेशन लाइब्रेरी, इस्तेमाल करने से पहले डाइनैमिक रूप से लोड हो जाती हैं. सही लाइब्रेरी को लोड करने के लिए दिया गया कोड, शामिल की गई स्क्रिप्ट का हिस्सा होता है. google.charts.load() तरीके को शुरू करने पर, इसे कॉल किया जाता है. हमारी सेवा की शर्तों के मुताबिक, google.charts.load या google.visualization कोड को ऑफ़लाइन इस्तेमाल करने के लिए डाउनलोड नहीं किया जा सकता.
क्या चार्ट कोड को स्थानीय तौर पर या किसी इंट्रानेट पर डाउनलोड और होस्ट किया जा सकता है?
माफ़ करें; हमारी सेवा की शर्तें आपको google.charts.load या google.visualization कोड को डाउनलोड और सेव करने या होस्ट करने की अनुमति नहीं देती हैं. हालांकि, अगर आपको Google चार्ट के साथ इंटरैक्ट करने की सुविधा नहीं चाहिए, तो चार्ट का स्क्रीनशॉट लिया जा सकता है और उन्हें अपने हिसाब से इस्तेमाल किया जा सकता है.

समस्या हल करना

मेरा चार्ट क्यों नहीं दिख रहा?

सबसे पहले, अपने JavaScript कंसोल की जांच करें. Chrome पर, Chrome->व्यू->डेवलपर->JavaScript कंसोल या Chrome->टूल->JavaScript कंसोल के ज़रिए JavaScript कंसोल को ऐक्सेस किया जा सकता है. सभी मॉडर्न ब्राउज़र में JavaScript कंसोल होता है. इसे खोजने के लिए आपको "ऐडवांस" या "डेवलपर टूल" जैसे नाम वाले मेन्यू देखने पड़ सकते हैं.

उम्मीद है, कंसोल आपको समस्या तक तुरंत पहुंचा देगा. हालांकि, कभी-कभी कंसोल मैसेज का अनुवाद मूल वजह तक करना मुश्किल हो सकता है. यहां कुछ सामान्य गलतियों के बारे में बताया गया है:

  • ऐसा हो सकता है कि 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).
  • टाइपिंग की गलतियां ढूंढें. याद रखें कि JavaScript एक केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) है.

अगर आपको अब भी कोई समस्या नहीं है, तो Google विज़ुअलाइज़ेशन एपीआई चर्चा ग्रुप खोजें और देखें कि क्या किसी को भी इसी तरह की समस्या मिली थी. अगर आपको अपने सवाल का जवाब देने वाली कोई पोस्ट नहीं मिलती है, तो समस्या को दिखाने वाले वेब पेज के लिंक के साथ अपना सवाल ग्रुप में पोस्ट करें. अगर हो सके, तो jsfiddle वाली का नाम शामिल करें.

मेरे महीने और दिन अलग-अलग क्यों हैं?
Google चार्ट में JavaScript का इस्तेमाल किया जाता है, जिसमें किसी भी तरीके को इंडेक्स करने की सुविधा का इस्तेमाल नहीं किया जाता है. महीने का पहला दिन 0 है और महीने 0 (जनवरी) से 11 (दिसंबर) तक होते हैं. अगर आपका कोड यह मानता है कि इंडेक्स करने के लिए एक तरीके का इस्तेमाल किया गया है, तो अपने डेटा को JavaScript के तारीख वाले ऑब्जेक्ट में डालने से पहले, एक कोड को घटाएं.
मेरे चार्ट कुछ ब्राउज़र में ही काम करते हैं, लेकिन सभी में नहीं, ऐसा क्यों होता है?
हम caniuse.com का सुझाव देते हैं कि ब्राउज़र कैसा काम नहीं कर रहा है, इसके बारे में जानकारी पाएं. 'Google चार्ट' में, कभी-कभी Internet Explorer 8 और इससे पहले के वर्शन में दो वजहों से समस्याएं हो सकती हैं:
  • IE8 पर SVG फ़ाइल काम नहीं करती. इसलिए, VML में चार्ट काम नहीं करते, क्योंकि इसकी संख्या सीमित है.
  • IE8 का JavaScript सूचियों में ट्रेलिंग कॉमा की अनुमति नहीं देता है.
    • मेरे द्वारा परीक्षण करते समय मेरा फ़्लैश-आधारित चार्ट क्यों नहीं दिखाई देता?
    ऐसा हो सकता है कि फ़्लैश सुरक्षा सेटिंग की वजह से, किसी वेब सर्वर यूआरएल (जैसे कि http://www.myhost.com/myviz.html) के बजाय, ब्राउज़र में किसी फ़ाइल की जगह (जैसे, file:///c:/webhost/myhost/myviz.html) से ऐक्सेस किए जाने पर, फ़्लैश-आधारित चार्ट ठीक से काम न करें. आम तौर पर, यह समस्या सिर्फ़ टेस्टिंग से जुड़ी होती है. http:// पते से चार्ट ऐक्सेस करने पर यह समस्या नहीं होती. इस समस्या को हल करने के लिए, Macromedia की वेबसाइट पर बताया गया तरीका अपनाएं. आम तौर पर, हमारा सुझाव है कि जहां भी हो सके फ़्लैश डेवलपमेंट से बचें.

    Google विज़ुअलाइज़ेशन कार्यक्रम नीति

    Google विज़ुअलाइज़ेशन प्रोग्राम नीति क्या है?
    जैसा कि सेवा की शर्तों में बताया गया है, हम अपने कार्यक्रम की नीति का उल्लंघन करने वाले कॉन्टेंट को शामिल करने और दिखाने से मना कर सकते हैं. इसके लिए, हम इन चीज़ों को दिखाते हैं या लिंक करते हैं:
    • गैर-कानूनी कॉन्टेंट.
    • निजी निजता पर हमला.
    • पोर्नोग्राफ़ी या अश्लीलता.
    • कॉन्टेंट, जैसे कि नुकसान पहुंचाने वाला कोड, जो उपयोगकर्ता के कंप्यूटर या होस्ट वेब पेज के काम करने के तरीके में रुकावट डालता है या नुकसान पहुंचाता है.
    • नफ़रत को बढ़ावा देना या हिंसा को बढ़ावा देना.
    • कॉपीराइट का उल्लंघन. ज़्यादा जानकारी के लिए, कृपया हमारी डीएमसीए (DMCA) नीति देखें.
    • ट्रेडमार्क का उल्लंघन.
    • तीसरे पक्षों की पहचान चुराना.

    डेटा इकट्ठा करने वाले चार्ट बनाने वाले डेवलपर, डेटा का रखरखाव करने और कानूनी तौर पर सही निजता नीति से लिंक करने के लिए सहमत होते हैं. इसके अलावा, हम चाहते हैं कि डेवलपर यह पक्का करें कि उनका चार्ट सुरक्षित है. साथ ही, जब तक वह चार्ट डायरेक्ट्री में रहता है, तब तक उनका ऐप्लिकेशन बनाए रखें.

    इन नीतियों में समय-समय पर बिना किसी सूचना के बदलाव किया जा सकता है.

    क्या Google विज़ुअलाइज़ेशन API व्यावसायिक इस्तेमाल के लिए उपलब्ध है?
    हां. छोटे अक्षरों में लिखने के लिए, कृपया Google विज़ुअलाइज़ेशन एपीआई की सेवा की शर्तें देखें.
    क्या क्लाइंट-साइड सॉफ़्टवेयर बनाने के लिए, Google विज़ुअलाइज़ेशन एपीआई का इस्तेमाल किया जा सकता है?
    फ़िलहाल, हम डेवलपर को क्लाइंट-साइड सॉफ़्टवेयर बनाने के लिए, विज़ुअलाइज़ेशन एपीआई का इस्तेमाल करने की अनुमति नहीं देते. विज़ुअलाइज़ेशन एपीआई का इस्तेमाल सिर्फ़ दिए गए इंटरफ़ेस की मदद से ही किया जा सकता है. छोटे अक्षरों में लिखने के लिए, कृपया Google विज़ुअलाइज़ेशन एपीआई की सेवा की शर्तें देखें.
    क्या Google मेरे चार्ट का पूरा डेटा लॉग कर रहा है?
    एचटीटीपी अनुरोध में शामिल चार्ट के डेटा को अस्थायी लॉग में दो हफ़्तों से ज़्यादा समय तक सेव करके रखा जाता है. इंटरनल टेस्टिंग और डीबग करने के मकसद से ऐसा किया जाता है. बेशक, आपको यह समझना चाहिए कि अगर आपका चार्ट किसी सार्वजनिक वेबपेज पर मौजूद इमेज टैग में दिखता है, तो उसे क्रॉल किया जा सकता है.
    कार्यक्रम की नीतियों के उल्लंघन.
    कार्यक्रम की इन नीतियों का उल्लंघन करने पर, आपके चार्ट को बंद किया जा सकता है या हटाया जा सकता है. आने वाले समय में चार्ट अपलोड करने से ब्लैकलिस्ट किया जा सकता है, आपके Google खाते बंद किए जा सकते हैं, और/या आपके सभी चार्ट मिटाए जा सकते हैं.

    कम्यूनिटी में सक्रिय रहना

    मैं दूसरों के साथ अपना चार्ट ऐप्लिकेशन कैसे शेयर करूं?
    अपने चार्ट को चार्ट गैलरी में रखकर शुरुआत करें. अगर आप चाहें, तो अपनी साइट को फिर से लिंक करके अपना सोर्स कोड दिया जा सकता है. समुदाय से सुझाव पाने के लिए हमारे चर्चा समूह में शामिल हों.
    चार्ट गैलरी, विज़ुअलाइज़ेशन एपीआई का इस्तेमाल करने वाले ऐप्लिकेशन की सूची होती है. यह विज़ुअलाइज़ेशन डेवलपर समुदाय को चार्ट ऐप्लिकेशन शेयर करने के लिए एक मुख्य जगह देता है. गैलरी में अपना चार्ट ऐप्लिकेशन सबमिट करने के लिए, ऑनलाइन आवेदन करें.
    मैं अपने चार्ट के डेटा सोर्स का प्रमोशन कैसे करूं?
    विज़ुअलाइज़ेशन ग्रुप में, लागू किया गया तरीका पोस्ट करें. अगर हमें वह कॉन्टेंट पसंद आता है, तो हो सकता है कि हम खुद ही उसका ज़िक्र करें.