चार्ट का इस्तेमाल शुरू करना

इस पेज पर चार्ट बनाने के लिए, चार्ट एपीआई के इस्तेमाल की बुनियादी जानकारी है.

Google चार्ट उपयोग नीति

Google चार्ट API में हर दिन कितने कॉल किए जा सकते हैं, इसकी कोई सीमा नहीं है. हालांकि, हमारे पास ऐसे किसी भी इस्तेमाल को ब्लॉक करने का अधिकार है जिसे हम गलत मानते हैं.

खास जानकारी

इस दस्तावेज़ में चार्ट देखना

इस दस्तावेज़ में मौजूद सभी चार्ट इमेज, चार्ट एपीआई का इस्तेमाल करके लाइव की गई हैं. किसी भी इमेज का यूआरएल देखने के लिए, नीचे दिया गया तरीका अपनाएं:

• अगर आप Firefox का इस्तेमाल कर रहे हैं, तो दायां क्लिक करें और फिर "इमेज देखें" या "प्रॉपर्टी" को चुनें.
• अगर आप Internet Explorer का इस्तेमाल कर रहे हैं, तो दायां क्लिक करें और फिर &प्रॉपर्टी&कोट करें को चुनें.

यूआरएल को पढ़ने में आसान बनाने के लिए, यह दस्तावेज़ अक्सर इसे कई लाइनों में दिखाता है. Google चार्ट API का इस्तेमाल करते समय, आपको एक लाइन में एक यूआरएल देना होगा.

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

सबसे आसान चार्ट बनाने के लिए, आपको यूआरएल के बारे में बस इतना बताना होगा कि वह चार्ट टाइप, डेटा, और साइज़ है. आप इस यूआरएल को सीधे अपने ब्राउज़र में टाइप कर सकते हैं या अपने वेब पेज में <img> टैग इस्तेमाल करके, इस यूआरएल पर जा सकते हैं. उदाहरण के लिए, पाई चार्ट के लिए इस लिंक पर जाएं:

https://chart.googleapis.com/chart?chs=250x100&chd=t:60,40&cht=p3&chl=Hello|World

 

पिछला लिंक, बेसिक चार्ट API यूआरएल का उदाहरण है. चार्ट के सभी यूआरएल के फ़ॉर्मैट इस तरह से होते हैं:

https://chart.googleapis.com/chart?cht=<chart_type>&chd=<chart_data>&chs=<chart_size>&...additional_parameters...

सभी यूआरएल, https://chart.googleapis.com/chart? से शुरू होते हैं और उसके बाद वे पैरामीटर होते हैं जो चार्ट के डेटा और दिखावट के बारे में बताते हैं. पैरामीटर, name=value वाले जोड़े होते हैं, जिन्हें एंपरसैंड वर्ण (&) से अलग किया जाता है. पैरामीटर ? के बाद, किसी भी क्रम में हो सकते हैं. सभी चार्ट के लिए कम से कम ये पैरामीटर ज़रूरी हैं: cht (चार्ट टाइप), chd (डेटा), और chs (चार्ट का साइज़). हालांकि, अन्य विकल्पों के लिए कई और पैरामीटर हैं. साथ ही, आप चार्ट की सुविधा के लिए ज़्यादा से ज़्यादा पैरामीटर तय कर सकते हैं.

ऊपर दिए गए यूआरएल की ज़्यादा जानकारी के साथ जांच करें:

यूआरएल

घटक

https://chart.googleapis.com/chart?   cht=p3&   chs=250x100&   chd=t:60,40&   chl=Hello|World

https://chart.googleapis.com/chart? यह सभी चार्ट अनुरोधों के लिए बेस यूआरएल है. cht=p3 चार्ट टाइप: यहां एक 3D पाई चार्ट है. chs=250x100 चार्ट का साइज़ (चौड़ाई x ऊंचाई), पिक्सल में. ज़्यादा से ज़्यादा वैल्यू यहां देखें. chd=t:60,40 चार्ट का डेटा. यह डेटा सामान्य टेक्स्ट फ़ॉर्मैट में है, लेकिन अन्य फ़ॉर्मैट भी हैं. chl=Hello|World स्लाइस लेबल. & पैरामीटर एक एंपरसैंड से अलग किए गए हैं. ध्यान दें: जब यूआरएल को एचटीएमएल में जोड़ा जाता है, जैसे कि <img> टैग के src एट्रिब्यूट के तौर पर, तो आपको & के साथ पैरामीटर को बदलना होगा. इसमें &amp; की या किसी दूसरी भाषा के साथ पेज एचटीएमएल जनरेट करना शामिल है. हालांकि, ब्राउज़र में यूआरएल टाइप करते समय या कोड में यूआरएल को कॉल करते समय, उदाहरण के लिए आपको & मार्क का इस्तेमाल करना चाहिए. उदाहरण के लिए, PHP या Perl में कोई यूआरएल फ़ेच करते समय.

इस यूआरएल को कॉपी करें और अपने ब्राउज़र में चिपकाएं और कुछ बदलाव करें: डेटा में और वैल्यू जोड़ें (don' इस वैल्यू को हर नए डेटा वैल्यू से पहले जोड़ना न भूलें. नए लेबल जोड़ें (हर नई वैल्यू से पहले | का निशान लगाएं). चार्ट को बड़ा करें.

पेज पर सबसे ऊपर जाएं

चार्ट बनाने का तरीका

इमेज चार्ट बनाने का तरीका यहां देखें:

1. चार्ट का टाइप तय करें. चार्ट की सूची देखने के लिए, गैलरी देखें; चार्ट टाइप cht पैरामीटर से तय किया जाता है. उन सभी कॉम्पोनेंट को स्केच करें जो आपको अपने चार्ट में चाहिए (ऐक्स, लेबल, बैकग्राउंड वगैरह). अगर ज़रूरी हो, तो अलग-अलग कॉम्पोनेंट (कुल चार्ट साइज़, लेजेंड साइज़, वगैरह) के लिए पिक्सल डाइमेंशन तय करें. आपको पहले अपने चार्ट टाइप से जुड़े दस्तावेज़ पढ़ लेने चाहिए या फिर आपको परेशानी हो सकती है.
2. अपना चार्ट डेटा बनाएं और उसे फ़ॉर्मैट करें. chd पैरामीटर का इस्तेमाल करके, डेटा के बारे में बताया गया है. आपको यह तय करना होगा कि आपके डेटा के लिए किस फ़ॉर्मैट का इस्तेमाल किया जाए:
   • डेटा फ़ॉर्मैट चुनें. आप अपने चार्ट डेटा के लिए टेक्स्ट के आसान फ़ॉर्मैट का इस्तेमाल कर सकते हैं, जो पढ़ने में आसान है. हालांकि, इसे भेजने के लिए ज़्यादा जगह की ज़रूरत होती है. इसके अलावा, आप किसी एक तरह के एन्कोडिंग कोड का इस्तेमाल कर सकते हैं, जो भेजने के लिए छोटा होता है. हालांकि, आप भेजे जाने वाले वैल्यू की रेंज पर पाबंदी लगा सकते हैं.
   • तय करें कि आपके डेटा को आपके चार्ट में फ़िट करने के लिए स्केल करना है या नहीं. अलग-अलग फ़ॉर्मैट में, वैल्यू की अलग-अलग रेंज इस्तेमाल की जा सकती हैं. ऐसा हो सकता है कि आप डेटा को इस तरह स्केल करना चाहें कि वह आपके फ़ॉर्मैट में इस्तेमाल की जा सकने वाली वैल्यू की पूरी रेंज शामिल कर सके. इससे, कीमतों में फ़र्क़ साफ़ तौर पर पता चलेगा. आप या तो अपने डेटा के साइज़ के मुताबिक डेटा को साइज़ के हिसाब से स्केल करें या कस्टम स्केलिंग का इस्तेमाल करके टेक्स्ट फ़ॉर्मैट का इस्तेमाल करें.
   • ज़रूरी होने पर अपने डेटा को कोड में बदलें. अगर आपने कोड में बदला हुआ फ़ॉर्मैट चुना है, तो हम कोड में बदलने के दूसरे तरीकों में मदद करने के लिए कुछ JavaScript ऑफ़र करते हैं.
3. चार्ट का साइज़ बताएं. चार्ट का साइज़ chs पैरामीटर का इस्तेमाल करके तय किया जाता है. फ़ॉर्मैट और ज़्यादा से ज़्यादा वैल्यू के लिए दस्तावेज़ देखें.
4. कुछ और पैरामीटर जोड़ें. हर चार्ट में उपलब्ध वैकल्पिक पैरामीटर की सूची होती है. सामान्य विकल्पों में लेबल, शीर्षक, और रंग शामिल हैं. ध्यान दें कि सभी लेबल या शीर्षक के टेक्स्ट को UTF-8 कोड में बदलना ज़रूरी है. ध्यान दें कि कई पैरामीटर की मदद से, आप एक से ज़्यादा वैल्यू डाल सकते हैं. उदाहरण के लिए, chm पैरामीटर की मदद से आप चार्ट पर एक डेटा पॉइंट रखें. आप chm पैरामीटर का इस्तेमाल करके, कई डेटा पॉइंट पर आकार रख सकते हैं. हालांकि, ऐसा करने के लिए, आप अपने यूआरएल में कई बार chm पैरामीटर को नहीं शामिल कर सकते हैं (उदाहरण के लिए, गलत: chm=square&chm=circle&chm=triangle). इसके बजाय, एक से ज़्यादा वैल्यू वाले पैरामीटर, जैसे कि कॉमा या वर्टिकल बार का इस्तेमाल एक ही पैरामीटर में कई वैल्यू के बीच में करते हैं. chm के लिए यह एक बार है. इसलिए, आपके पास कुछ ऐसा होगा: राइट: chm=square|circle|triangle. हर पैरामीटर की जानकारी देखकर, कई पैरामीटर के बारे में बताने का तरीका जानें.
5. यूआरएल की स्ट्रिंग बनाएं. यूआरएल https://chart.googleapis.com/chart? से शुरू होता है और आपके सभी ज़रूरी (cht, chd, chs) और वैकल्पिक पैरामीटर मौजूद होते हैं. ध्यान दें: अगर आप <img> टैग में अपने यूआरएल का इस्तेमाल कर रहे हैं, तो आपको अपने लिंक में मौजूद सभी & वर्णों को & में बदलना होगा. उदाहरण: <img src="https://chart.googleapis.com/chart?chs=250x100&amp;chd=t:60,40&amp;cht=p3&amp;chl=Hello|World" />.
6. अपनी इमेज पाने के लिए, GET या POST का इस्तेमाल करें. जीईटी तब होता है, जब अपने ब्राउज़र में सीधे यूआरएल टाइप किया जाता है या <img> टैग में इसका इस्तेमाल किया जाता है. हालांकि, यूआरएल की लंबाई 2K तक होती है, इसलिए अगर आपके पास उससे ज़्यादा डेटा है या आप उसका स्वाद पसंद करते हैं, तो आपको यहां बताए गए तरीके से POST का इस्तेमाल करना चाहिए.
7. क्लिक किए जा सकने वाले इलाके बनाएं. वैकल्पिक रूप से उस चार्ट के लिए इमेज मैप बनाया जा सकता है जिससे आप खास चार्ट एलिमेंट में हाइपरलिंक या क्लिक एलिमेंट जोड़ पाएंगे. ज़्यादा जानकारी के लिए, चार्ट इमेज मैप बनाना देखें.

पेज पर सबसे ऊपर जाएं

चार्ट की शर्तें

इस दस्तावेज़ में इस्तेमाल किए जाने वाले कुछ अहम शब्द यहां दिए गए हैं:

सीरीज़

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

ऐक्सिस लेबल

हर ऐक्सिस में अंक या टेक्स्ट की वैल्यू. पिछले चार्ट में, ये लेबल और &कोट,"फ़रवरी," "mar," "0," "50," "100.&quot होंगे.

चार्ट के कॉम्पोनेंट

यहां चार्ट के कुछ कॉम्पोनेंट दिए गए हैं:

चार्ट का इलाका

सीरीज़ की कला दिखाने वाला इलाका. ज़्यादा जानकारी के लिए, चार्ट कॉम्पोनेंट और कोटेशन वाले साइडबार को देखें.

लेजेंड

चार्ट पर मौजूद छोटा सा सीरीज़ जो सीरीज़ के बारे में बताता है. ऊपर दिए गए चार्ट में, वह सेक्शन है जिसमें &cats" "Dogs" है.

पैरामीटर

यूआरएल में इस्तेमाल की गई key=value वैल्यू. उदाहरण के लिए: chxt=x, जहां पैरामीटर का नाम chxt है, पैरामीटर की वैल्यू x है.

पाएं और पोस्ट करें

आपका चार्ट यूआरएल भेजने के दो तरीके. आम तौर पर, जीईटी में ब्राउज़र में यूआरएल टाइप करके या उसे <img> टैग का सोर्स बनाकर किया जाता है. पोस्ट अनुरोध करना ज़्यादा मुश्किल है, लेकिन इनमें काफ़ी ज़्यादा डेटा शामिल हो सकता है. GET के बजाय POST का इस्तेमाल करने की मुख्य वजह यह है कि POST के अनुरोध को जीईटी अनुरोध (16 हज़ार वर्ण बनाम 2K वर्ण) की तुलना में ज़्यादा डेटा लग सकता है. POST की जानकारी यहां दी गई है.

पिप वर्ण

| वर्ण, जिसे अक्सर पैरामीटर वैल्यू डीलिमिटेड के तौर पर इस्तेमाल किया जाता है. इसका मतलब है, एक वर्ण जो कई वैल्यू को अलग-अलग करता है. चार्ट यूआरएल में, कॉमा और एंपरसैंड (&) का इस्तेमाल डीलिमिटर के तौर पर भी किया जाता है.

कंपाउंड चार्ट

ऐसा चार्ट जिसमें दो तरह के चार्ट शामिल होते हैं: उदाहरण के लिए, लाइन वाला बार चार्ट या मोमबत्ती के निशान वाले लाइन चार्ट. कंपाउंड चार्ट देखें.

पेज पर सबसे ऊपर जाएं

ऑप्टिमाइज़ेशन

अब जब आपने चार्ट बनाने की बुनियादी बातें सीख ली हैं, तो यहां कुछ ऑप्टिमाइज़ेशन के बारे में बताया गया है जिनका इस्तेमाल आप कर सकते हैं.

POST का इस्तेमाल करना

यूआरएल की लंबाई 2 हज़ार तक होती है. इसलिए, अगर आपके चार्ट में उससे ज़्यादा डेटा है, तो आपको GET के बजाय, POST का इस्तेमाल करना होगा, जैसा कि यहां बताया गया है. GET तब होता है, जब आप अपने ब्राउज़र के यूआरएल बार में चार्ट यूआरएल लिखते हैं या इसे वेब पेज में <img> एलिमेंट के स्रोत के तौर पर इस्तेमाल करते हैं. POST को किसी दूसरी भाषा, जैसे कि PHP या PERL में और प्रोग्रामिंग की ज़रूरत होती है.

JavaScript में चार्ट बनाना

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