खास जानकारी
एनोटेशन चार्ट, इंटरैक्टिव टाइम सीरीज़ लाइन चार्ट होते हैं, जो एनोटेशन के साथ काम करते हैं. ध्यान दें कि एनोटेट की गई टाइमलाइन अब अपने-आप एनोटेशन चार्ट का इस्तेमाल करती है.
भ्रम की चेतावनी: फ़िलहाल, Google एनोटेशन चार्ट एनोटेशन से अलग है, जो अन्य Google चार्ट (मौजूदा क्षेत्र, बार, कॉलम, कॉम्बो, लाइन, और स्कैटर) के लिए काम करता है. ऐसे चार्ट में, एनोटेशन को एक अलग डेटा टेबल कॉलम में दिखाया जाता है. साथ ही, उन्हें टेक्स्ट के छोटे-छोटे हिस्सों में दिखाया जाता है, जिस पर उपयोगकर्ता पूरा टेक्स्ट पढ़ने के लिए कर्सर घुमा सकते हैं. इसके उलट, व्याख्या चार्ट में दाईं ओर दिया गया पूरा एनोटेशन दिखाया गया है, जैसा कि नीचे दिखाया गया है.
उदाहरण
<html> <head> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type='text/javascript'> google.charts.load('current', {'packages':['annotationchart']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = new google.visualization.DataTable(); data.addColumn('date', 'Date'); data.addColumn('number', 'Kepler-22b mission'); data.addColumn('string', 'Kepler title'); data.addColumn('string', 'Kepler text'); data.addColumn('number', 'Gliese 163 mission'); data.addColumn('string', 'Gliese title'); data.addColumn('string', 'Gliese text'); data.addRows([ [new Date(2314, 2, 15), 12400, undefined, undefined, 10645, undefined, undefined], [new Date(2314, 2, 16), 24045, 'Lalibertines', 'First encounter', 12374, undefined, undefined], [new Date(2314, 2, 17), 35022, 'Lalibertines', 'They are very tall', 15766, 'Gallantors', 'First Encounter'], [new Date(2314, 2, 18), 12284, 'Lalibertines', 'Attack on our crew!', 34334, 'Gallantors', 'Statement of shared principles'], [new Date(2314, 2, 19), 8476, 'Lalibertines', 'Heavy casualties', 66467, 'Gallantors', 'Mysteries revealed'], [new Date(2314, 2, 20), 0, 'Lalibertines', 'All crew lost', 79463, 'Gallantors', 'Omniscience achieved'] ]); var chart = new google.visualization.AnnotationChart(document.getElementById('chart_div')); var options = { displayAnnotations: true }; chart.draw(data, options); } </script> </head> <body> <div id='chart_div' style='width: 900px; height: 600px;'></div> </body> </html>
लोड हो रहा है
google.charts.load
पैकेज का नाम "annotationchart"
है.
google.charts.load("current", {packages: ['annotationchart']});
विज़ुअलाइज़ेशन की क्लास का नाम google.visualization.AnnotationChart
है.
var visualization = new google.visualization.AnnotationChart(container);
डेटा फ़ॉर्मैट
चार्ट में एक या एक से ज़्यादा लाइनें दिखाई जा सकती हैं. हर लाइन, चार्ट पर X जगह के बारे में बताती है—यानी एक खास समय; हर लाइन को एक से तीन कॉलम के एक सेट से दिखाया जाता है.
- पहला कॉलम
date
याdatetime
टाइप का है और चार्ट पर पॉइंट की X वैल्यू बताता है. अगर यह कॉलम,date
के बजायdatetime
का है, तो X ऐक्सिस पर सबसे कम समय वाला रिज़ॉल्यूशन एक दिन होगा. - इसके बाद, हर डेटा लाइन के बारे में एक से तीन अतिरिक्त कॉलम के सेट से बताया जाता है, जैसा कि यहां बताया गया है:
- Y वैल्यू - [ज़रूरी है, संख्या] हर सेट के पहले कॉलम में, पहले कॉलम से जुड़ी समय पर लाइन की वैल्यू की जानकारी होती है. कॉलम लेबल को चार्ट पर उस लाइन के शीर्षक के रूप में दिखाया जाता है.
- एनोटेशन का शीर्षक - [ज़रूरी नहीं, स्ट्रिंग] अगर कोई स्ट्रिंग कॉलम, वैल्यू कॉलम को फ़ॉलो करता है और
displayAnnotations
विकल्प 'सही' है, तो इस कॉलम में इस पॉइंट के बारे में बताने वाला एक छोटा शीर्षक होगा. उदाहरण के लिए, अगर इस लाइन से ब्राज़ील में तापमान के बारे में पता चलता है और यह पॉइंट एक बहुत बड़ी संख्या है, तो शीर्षक "रिकॉर्ड में सबसे लोकप्रिय दिन" हो सकता है. - एनोटेशन टेक्स्ट - [वैकल्पिक स्ट्रिंग] अगर इस सीरीज़ के लिए कोई दूसरा स्ट्रिंग कॉलम मौजूद है, तो सेल पॉइंट का इस्तेमाल इस पॉइंट के लिए जानकारी देने वाले अतिरिक्त टेक्स्ट के रूप में किया जाएगा. इस कॉलम का इस्तेमाल करने के लिए, आपको
displayAnnotations
को सही पर सेट करना होगा. एचटीएमएल टैग का इस्तेमाल करने के लिए,allowHtml
कोtrue
पर सेट किया जा सकता है. साइज़ की कोई सीमा नहीं होती है. हालांकि, ध्यान रखें कि ज़रूरत से ज़्यादा लंबे एंट्री, डिसप्ले सेक्शन में ओवरफ़्लो हो सकते हैं. आपके पास इस कॉलम का होना ज़रूरी नहीं है, भले ही आपके पास इस पॉइंट के लिए एनोटेशन का शीर्षक कॉलम हो. चार्ट लेबल का इस्तेमाल नहीं करता है. उदाहरण के लिए, अगर रिकॉर्ड के हिसाब से यह सबसे गर्म दिन था, तो आप "अगला नज़दीकी दिन 10 डिग्री कूलर था!" जैसा कुछ कह सकते हैं.
कॉन्फ़िगरेशन के विकल्प
नाम | |
---|---|
अनुमति है, एचटीएमएल |
अगर इस नीति को 'सही है' पर सेट किया जाता है, तो एचटीएमएल टैग वाले किसी भी एनोटेशन टेक्स्ट को एचटीएमएल के तौर पर रेंडर किया जाएगा. टाइप: बूलियन
डिफ़ॉल्ट: गलत
|
AllValuesSuffix |
लेजेंड के सभी मानों में जोड़ा जाने वाला प्रत्यय और लंबवत अक्ष में लेबल टिक करें. टाइप: स्ट्रिंग
डिफ़ॉल्ट: कोई नहीं
|
एनोटेशन की चौड़ाई |
पूरे चार्ट एरिया से, एनोटेशन एरिया की चौड़ाई (प्रतिशत में). 5-80 की रेंज में होना चाहिए. टाइप: नंबर
डिफ़ॉल्ट: 25
|
कलर |
चार्ट लाइनों और लेबल के लिए इस्तेमाल होने वाले रंग. स्ट्रिंग की श्रेणी. हर एलिमेंट एक मान्य एचटीएमएल कलर फ़ॉर्मैट वाली स्ट्रिंग है. जैसे, 'लाल' या '#00cc00'. टाइप: स्ट्रिंग की कैटगरी
डिफ़ॉल्ट: डिफ़ॉल्ट रंग
|
तारीख वाला फ़ॉर्मैट |
सबसे ऊपर दाएं कोने में तारीख की जानकारी दिखाने के लिए इस्तेमाल किया जाने वाला फ़ॉर्मैट. इस फ़ील्ड का फ़ॉर्मैट, java SimpleDateFormat क्लास की ओर से तय किया गया है. टाइप: स्ट्रिंग
डिफ़ॉल्ट:
पहले कॉलम के टाइप (तारीख या तारीख और समय) के आधार पर 'MMMM dd, yyyy' या 'HH:mm MMMM yyyy, yyyy'
को चुना जा सकता है.
|
डिसप्ले एनोटेशन |
अगर इस नीति को 'गलत है' पर सेट किया जाता है, तो चार्ट पर एनोटेशन टेबल को नहीं दिखाया जाएगा. साथ ही, अगर आपके डेटा में कोई भी एनोटेशन नहीं है, तो एनोटेशन टेबल और एनोटेशन टेक्स्ट नहीं दिखेगा. भले ही, इस विकल्प से कोई भी इंटरैक्ट न करता हो. अगर यह विकल्प 'सही' पर सेट है, तो हर संख्या वाले कॉलम के बाद, दो वैकल्पिक एनोटेशन स्ट्रिंग कॉलम जोड़े जा सकते हैं. एक एनोटेशन टेक्स्ट के लिए और एक एनोटेशन के शीर्षक के लिए. टाइप: बूलियन
डिफ़ॉल्ट: true
|
डिसप्ले एनोटेशन फ़िल्टर |
अगर इस नीति को 'सही है' पर सेट किया जाता है, तो चार्ट पर एनोटेशन को फ़िल्टर करने के लिए फ़िल्टर कंट्रोल दिखेगा. कई एनोटेशन होने पर, इस विकल्प का इस्तेमाल करें. टाइप: बूलियन
डिफ़ॉल्ट: गलत
|
डिसप्ले तारीख बार सेपरेटर |
क्या सीरीज़ की वैल्यू और लेजेंड में तारीख के बीच, छोटा बार विभाजक ( | ) दिखाना है, जहां सही का मतलब हां है. टाइप: बूलियन
डिफ़ॉल्ट: true
|
DisplayExactValues दिखाएं |
क्या जगह बचाने के लिए, ग्राफ़ के ऊपर मान के छोटे और गोल किए गए वर्शन को दिखाना चाहिए; गलत से पता चलता है कि वह गलत है. उदाहरण के लिए, अगर गलत पर सेट किया जाता है, तो 56123.45 को 56.12k के रूप में दिखाया जा सकता है. टाइप: बूलियन
डिफ़ॉल्ट: गलत
|
लेजेंड लेजेंड |
लेजेंड टेक्स्ट की वैल्यू के आगे बिंदु दिखाने हैं या नहीं, जहां सही का मतलब हां होता है. टाइप: बूलियन
डिफ़ॉल्ट: true
|
displayLegendValues |
क्या लेजेंड में हाइलाइट की गई वैल्यू दिखानी हैं, जहां सही का मतलब है हां. टाइप: बूलियन
डिफ़ॉल्ट: true
|
DisplayRangeSelector |
क्या ज़ूम रेंज चुनने का इलाका दिखाया जाना चाहिए (चार्ट के नीचे वाला इलाका), जहां गलत का मतलब है कि नहीं. ज़ूम चुनने वाले टूल में आउटलाइन, चार्ट की पहली सीरीज़ का लॉग स्केल वर्शन है. इसे ज़ूम सिलेक्टर की ऊंचाई में फ़िट करने के लिए बढ़ाया गया है. टाइप: बूलियन
डिफ़ॉल्ट: true
|
DisplayZoomButtons |
क्या ज़ूम बटन दिखाना है (1d 5d 1m" वगैरह), जहां गलत का मतलब नहीं है. टाइप: बूलियन
डिफ़ॉल्ट: true
|
भरें |
0 से 100 की संख्या (जिसमें सभी वैल्यू शामिल होती हैं). साथ ही, लाइन ग्राफ़ में हर लाइन के नीचे फ़िल का ऐल्फ़ा नंबर दिया जाता है. 100 का मतलब है 100% अपारदर्शी, और 0 का मतलब है बिलकुल नहीं. फ़िल कलर, उसके ऊपर की लाइन का रंग होता है. टाइप: नंबर
डिफ़ॉल्ट: 0
|
लेजेंड पोज़िशन |
रंगों वाले लेजेंड को, ज़ूम बटन और तारीख के साथ एक ही पंक्ति में रखें ('sameRow') या नई पंक्ति पर ('newRow'). टाइप: स्ट्रिंग
डिफ़ॉल्ट: 'sameRow'
|
ज़्यादा से ज़्यादा |
Y ऐक्सिस पर दिखाया जाने वाला ज़्यादा से ज़्यादा मान. अगर तय सीमा से ज़्यादा डेटा पॉइंट इस वैल्यू से ज़्यादा हो जाता है, तो इस सेटिंग को अनदेखा कर दिया जाएगा. इसके बाद, चार्ट में इस तरह बदलाव किया जाएगा कि यह तय किए गए ज़्यादा से ज़्यादा डेटा पॉइंट के ऊपर, अगला टिक मार्क दिखे. इसे यह कोर चार्ट में टाइप: नंबर
डिफ़ॉल्ट: अपने-आप
|
मि |
Y ऐक्सिस पर दिखाया जाने वाला कम से कम मान. अगर कम से कम डेटा पॉइंट इस वैल्यू से कम होगा, तो इस सेटिंग को अनदेखा कर दिया जाएगा. इसके बाद, चार्ट में बदलाव किया जाएगा, ताकि सबसे कम वैल्यू के नीचे, अगला सही का निशान दिखाया जा सके. इसे यह कोर चार्ट में टाइप: नंबर
डिफ़ॉल्ट: अपने-आप
|
नंबर फ़ॉर्मैट |
इस ग्राफ़ में सबसे ऊपर, वैल्यू के फ़ॉर्मैट बनाने के लिए संख्या फ़ॉर्मैट के पैटर्न के बारे में बताया जाता है. पैटर्न, java DecimalFormat क्लास के बताए हुए फ़ॉर्मैट में होना चाहिए.
अगर यह विकल्प बताया गया है, तो टाइप: स्ट्रिंग या नंबर का मैप:स्ट्रिंग पेयर
डिफ़ॉल्ट: अपने-आप
|
स्केलकॉलम |
यह तय करता है कि ग्राफ़ में Y ऐक्सिस के टिक मार्क पर कौनसी वैल्यू दिखानी हैं. डिफ़ॉल्ट रूप से, दाईं ओर एक स्केल होता है, जो दोनों सीरीज़ पर लागू होता है. हालांकि, ग्राफ़ की अलग-अलग साइड को, सीरीज़ की अलग-अलग वैल्यू पर स्केल किया जा सकता है. इस विकल्प को स्केल वैल्यू के रूप में इस्तेमाल करने के लिए, सीरीज़ की शून्य से तीन संख्याओं की श्रेणी (ज़ीरो आधारित) इंडेक्स मिलती है. आपकी प्रॉपर्टी की वैल्यू कहां दिखाई जाती हैं, यह इस बात पर निर्भर करता है कि आपने उनकी कैटगरी में कितनी वैल्यू शामिल की हैं:
एक से ज़्यादा स्केल दिखाते समय, टाइप: संख्याओं की कैटगरी
डिफ़ॉल्ट: अपने-आप
|
स्केलफ़ॉर्मैट |
ऐक्सिस के टिक लेबल के लिए इस्तेमाल किया जाने वाला नंबर फ़ॉर्मैट. टाइप: स्ट्रिंग
डिफ़ॉल्ट: smartl
|
स्केलटाइप |
Y ऐक्सिस पर दिखाए गए, ज़्यादा से ज़्यादा और कम से कम वैल्यू सेट करता है. ये विकल्प उपलब्ध हैं:
अगर आप कम से कम और/या ज़्यादा से ज़्यादा विकल्पों के बारे में बताते हैं, तो उन्हें आपके स्केल टाइप से तय की गई कम से कम और ज़्यादा से ज़्यादा वैल्यू पर प्राथमिकता दी जाएगी. टाइप: स्ट्रिंग
डिफ़ॉल्ट: 'ठीक कर दिया गया है'
|
टेबल |
एनोटेशन टेबल से जुड़े विकल्प शामिल हैं. इस ऑब्जेक्ट की प्रॉपर्टी बताने के लिए, आप ऑब्जेक्ट लिटरल नोटेशन का इस्तेमाल कर सकते हैं: var options: { table: { sortAscending: true, sortColumn: 1 } }; टाइप: ऑब्जेक्ट
डिफ़ॉल्ट: शून्य
|
table.sortAscending |
अगर नीति को टाइप: बूलियन
डिफ़ॉल्ट: गलत
|
टेबल का क्रम से लगाना |
एनोटेशन टेबल का कॉलम इंडेक्स, जिसके लिए एनोटेशन क्रम से लगाए जाएंगे. एनोटेशन टेक्स्ट कॉलम के लिए, इंडेक्स 0 होना चाहिए या एनोटेशन टेक्स्ट कॉलम के लिए 1 होना चाहिए. टाइप: नंबर
डिफ़ॉल्ट: 0
|
मोटाई |
0 से 10 तक की कोई संख्या (शामिल) जो लाइनों की मोटाई बताती है, जहां 0 सबसे छोटा होता है. टाइप: नंबर
डिफ़ॉल्ट: 0
|
ZoomEndTime |
चुनी गई ज़ूम सीमा की खत्म होने की तारीख/समय सेट करता है. टाइप: तारीख
डिफ़ॉल्ट: कोई नहीं
|
ZoomStartTime |
चुनी गई ज़ूम रेंज के शुरू होने की तारीख/समय सेट करता है. टाइप: तारीख
डिफ़ॉल्ट: कोई नहीं
|
तरीके
तरीका | |
---|---|
clearChart() |
चार्ट साफ़ करता है और अपने सभी आवंटित संसाधन रिलीज़ करता है. सामान लौटाने का टाइप: कोई नहीं
|
draw(data, options, state) |
चार्ट ड्रॉ करता है. सामान लौटाने का टाइप: कोई नहीं
|
getContainer() |
एनोटेशन चार्ट वाले कंटेनर एलिमेंट पर हैंडल वापस लाता है. सामान लौटाने का टाइप: डीओएम एलिमेंट को हैंडल करना
|
getSelection() |
मानक लौटाए गए आइटम का टाइप: चुने गए एलिमेंट की कैटगरी
|
getVisibleChartRange() |
सामान लौटाने का टाइप:
start और end प्रॉपर्टी वाला कोई ऑब्जेक्ट
|
hideDataColumns(columnIndexes) |
चार्ट से, बताई गई डेटा सीरीज़ को छिपाता है. इसमें एक ऐसा पैरामीटर स्वीकार किया जाता है जो संख्या या संख्याओं का अरे हो सकता है, जिसमें 0 का मतलब पहली डेटा सीरीज़ वगैरह से है. सामान लौटाने का टाइप: कोई नहीं
|
setVisibleChartRange(start, end) |
दिखाई देने वाली श्रेणी (ज़ूम) को तय सीमा पर सेट करता है. इस टाइप के दो पैरामीटर स्वीकार किए जाते हैं
सामान लौटाने का टाइप: कोई नहीं
|
showDataColumns(columnIndexes) |
सामान लौटाने का टाइप: कोई नहीं
|
इवेंट
नाम | |
---|---|
rangechange |
जब उपयोगकर्ता रेंज स्लाइडर में बदलाव करता है, तब सक्रिय होता है. नए रेंज एंडपॉइंट google.visualization.events.addListener(chart, 'rangechange', rangechange_handler); function rangechange_handler(e) { console.log('You changed the range to ', e['start'], ' and ', e['end']); } प्रॉपर्टी: शुरू, खत्म
|
ready |
चार्ट, मेथड कॉल के लिए तैयार है. चार्ट बनाने के बाद, अगर आपको चार्ट और इंटरैक्ट करने के तरीकों से इंटरैक्ट करना है, तो प्रॉपर्टी: कोई नहीं
|
select |
तब सक्रिय होता है, जब उपयोगकर्ता किसी विज़ुअल इकाई पर क्लिक करता है. अगर आपको चुना गया है, तो यह जानने के लिए
प्रॉपर्टी: कोई नहीं
|
डेटा नीति
सभी कोड और डेटा को ब्राउज़र में प्रोसेस किया जाता है और रेंडर किया जाता है. किसी भी सर्वर पर डेटा नहीं भेजा जाता.