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

शुरू करें

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

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

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

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

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

  • चार्ट को ऐक्सेस करने के लिए, विज़ुअलाइज़ेशन एपीआई एक JavaScript एपीआई उपलब्ध कराता है.
  • इसके चार्ट में Google के बनाए हुए चार्ट शामिल हैं. हालांकि, इसके साथ-साथ कोई तीसरा पक्ष भी अपने विज़ुअलाइज़ेशन के एपीआई के मुताबिक विज़ुअलाइज़ेशन बना सकता है.
  • विज़ुअलाइज़ेशन एपीआई चार्ट और चार्ट, ब्राउज़र से रेंडर किए जा सकने वाले कुछ भी हो सकते हैं. इसमें इमेज, JavaScript, वेक्टर-ग्राफ़िक्स, Flash वगैरह शामिल हैं.
  • ज़्यादातर चार्ट एपीआई को विज़ुअलाइज़ेशन एपीआई से ऐक्सेस किया जा सकता है. हालांकि, हो सकता है कि उनके कुछ कॉन्फ़िगरेशन विकल्प उपलब्ध न हों.
  • इस एपीआई का इस्तेमाल करके, दस्तावेज़ में तार वाला दस्तावेज़ भी मिलता है. इस प्रोटोकॉल की मदद से, कोई भी व्यक्ति अपने डेटा सोर्स को किसी भी एपीआई विज़ुअलाइज़ेशन को देख सकता है.
  • एपीआई में इवेंट का मॉडल तय किया गया है. इसकी मदद से, चार्ट इवेंट को फेंकते और पाते हैं. इसलिए, उनके होस्ट पेज और/या पेज पर मौजूद दूसरे चार्ट के साथ जानकारी शेयर की जाती है.
विज़ुअलाइज़ेशन एपीआई का इस्तेमाल करके, मैं किन डेटा सोर्स को ऐक्सेस कर सकता/सकती हूं?
विज़ुअलाइज़ेशन एपीआई की मदद से, एपीआई का स्टैंडर्ड DataTable फ़ॉर्मैट बनाकर, ब्राउज़र से अपने डिवाइस पर मौजूद डेटा ऐक्सेस किया जा सकता है. इसके अलावा, एपीआई का इस्तेमाल करने वाले किसी भी डेटा सोर्स को ऐक्सेस किया जा सकता है. एपीआई के साथ काम करने वाले जाने-माने ऐप्लिकेशन, Google Spreadsheets और Salesforce.com हैं जो force.com डेवलपर प्लैटफ़ॉर्म पर काम करते हैं. अपने डेटा को चार्ट डेटा सोर्स के तौर पर भी लागू किया जा सकता है.
मेरे ऐप्लिकेशन को उम्मीद है कि जो डेटा मिलेगा वह किसी खास फ़ॉर्मैट में होगा. मैं अपवादों को कैसे हैंडल करूं?
यह जांचने के लिए कि आपको जो डेटा मिल रहा है वह आपकी उम्मीद के मुताबिक है या नहीं, आपके पास getNumberOfColumns() और getColumnType() क्लास के तरीके google.visualization.DataTable का इस्तेमाल करने का विकल्प है. साथ ही, इसकी मदद से गड़बड़ी का मैसेज भेजा जा सकता है.
क्या मेरी वेबसाइट में चार्ट एम्बेड करना सुरक्षित है?
सीधे अपनी वेबसाइट पर तीसरे पक्ष का कोड चलाने से, जोखिम बढ़ सकता है. 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, सूचियों में कॉमा का इस्तेमाल करने की अनुमति नहीं देता है.
    • जब मैं अपने Flash-आधारित चार्ट की जांच कर रहा/रही हूं, तो वह क्यों नहीं दिखाई देता है?
    सुरक्षा सुरक्षा सेटिंग की वजह से, हो सकता है कि फ़्लैश-आधारित चार्ट, वेब सर्वर यूआरएल (जैसे कि http://www.myhost.com/myviz.html) के बजाय ब्राउज़र में फ़ाइल की जगह (जैसे, file:///c:/webhost/myhost/myviz.html) से ऐक्सेस किए जाने पर, ठीक से काम न करें. आम तौर पर, यह सिर्फ़ जांच से जुड़ी समस्या होती है. http:// पते से चार्ट ऐक्सेस करने पर भी कोई समस्या नहीं आती. MMedia की वेबसाइट पर जाकर, इस समस्या को हल किया जा सकता है. आम तौर पर, हम सुझाव देते हैं कि जब भी हो सके फ़्लैश डेवलपमेंट से बचें.

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

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

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

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

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

    कम्यूनिटी से जुड़ना

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