वर्शन

Maps JavaScript API टीम नियमित तौर पर इस एपीआई को नई सुविधाओं, गड़बड़ी ठीक करने, और परफ़ॉर्मेंस को बेहतर बनाने के लिए अपडेट करती है. यह पेज एपीआई के उन वर्शन के बारे में बताता है जो आपके ऐप्लिकेशन में इस्तेमाल करने के लिए उपलब्ध हैं.

रिलीज़ चैनल और वर्शन के नंबर

अपने ऐप्लिकेशन में आप रिलीज़ चैनल या वर्शन नंबर बता सकते हैं:

  • हर हफ़्ते का चैनल, v=weekly से तय किया गया है.
    यह चैनल हफ़्ते में एक बार अपडेट होता है और सबसे नया होता है.
  • चौथाई चैनल v=quarterly से तय किया गया है.
    इस चैनल को हर तीन महीने में एक बार अपडेट किया जाता है. इसका अनुमान पहले से लगाया जा सकता है.
  • बीटा चैनल को v=beta से तय किया गया है.
    यह चैनल, weekly चैनल के हिसाब से काम करता है और इसे हफ़्ते में एक बार अपडेट किया जाता है. इसमें शुरुआती टेस्टिंग और सुझाव, शिकायत या राय के लिए अतिरिक्त बदलाव शामिल हैं.
  • ऐल्फ़ा चैनल को v=alpha से तय किया गया है.
    यह चैनल, beta चैनल के हिसाब से काम करता है और इसे हफ़्ते में एक बार अपडेट किया जाता है. इसमें प्रोटोटाइप पर ग्राहकों के सुझाव/शिकायत/राय के लिए, प्रयोग शामिल हैं. यह सिर्फ़ डेवलपमेंट के लिए है. प्रोडक्शन में इसका इस्तेमाल नहीं किया जाना चाहिए.
  • वर्शन नंबर v=n.nn के साथ बताया गया है.
    आपके पास v=3.54, v=3.53, v=3.52 या v=3.51 को चुनने का विकल्प है.
    वर्शन नंबर हर तीन महीने में एक बार अपडेट किए जाते हैं (हर तीन महीने में अपडेट देखें).

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

हर हफ़्ते का चैनल चुनना

ज़्यादातर आवेदनों के लिए, हम हर हफ़्ते मिलने वाले चैनल का सुझाव देते हैं. यह सबसे नया और अप-टू-डेट वर्शन है. इसमें गड़बड़ियां ठीक की गई हैं और परफ़ॉर्मेंस में सुधार किए गए हैं. Maps JavaScript एपीआई को नीचे दिए गए स्क्रिप्ट टैग के साथ लोड करके, हर हफ़्ते के चैनल के बारे में बताएं:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=weekly
        &key=YOUR_API_KEY&callback=initMap">
</script>

फ़िलहाल, हर हफ़्ते का चैनल 3.54 वर्शन है. इस वर्शन को नई सुविधाओं, गड़बड़ी ठीक करने, और परफ़ॉर्मेंस में सुधार करने के साथ, हर हफ़्ते अपडेट किया जाता है.

नवंबर के बीच में, हर हफ़्ते के चैनल को 3.55 वर्शन पर अपडेट कर दिया जाएगा. ऐसे में हो सकता है कि इस नए वर्शन में, पुरानी सुविधाओं को हटा दिया जाए और/या पुराने सिस्टम के साथ काम न करने की सुविधा से जुड़ी सुविधाएं उपलब्ध कराई जा सकें.

तिमाही वाला चैनल चुनना

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

<script async
    src="https://maps.googleapis.com/maps/api/js?v=quarterly
        &key=YOUR_API_KEY&callback=initMap">
</script>

फ़िलहाल, हर तीन महीने में चैनल का वर्शन 3.53 है. इस तिमाही में इस वर्शन में नई सुविधाएं या गड़बड़ियां ठीक नहीं की जाएंगी. इसके अलावा, परफ़ॉर्मेंस में सुधार नहीं किया जा सकेगा. हम समय-समय पर इस वर्शन में सुरक्षा से जुड़ी गड़बड़ियां ठीक कर सकते हैं.

नवंबर के मध्य में, तिमाही चैनल को 3.54 वर्शन में अपडेट कर दिया जाएगा. उस समय, नए वर्शन में नई सुविधाएं, हटाई गई सुविधाओं को हटाना, और/या पिछले तीन महीनों के लिए पुराने सिस्टम के साथ काम करने से जुड़ी सुविधाएं शामिल होंगी.

बीटा चैनल चुनना

बीटा चैनल की नई सुविधाएं और बदलाव आज़माने के लिए, इसका इस्तेमाल करें. बीटा वर्शन की सुविधाएं पूरी तरह से उपलब्ध हैं, लेकिन हो सकता है कि उनमें कुछ गड़बड़ियां हों (कृपया समस्याओं की शिकायत करने और सुझाव/राय देने के लिए, समस्या को ट्रैक करने वाले टूल का इस्तेमाल करें). बीटा चैनल किसी भी सेवा स्तर समझौते (एसएलए) या बहिष्कार नीति में शामिल नहीं है, और हो सकता है कि कुछ बदलाव पिछली रिलीज़ के साथ काम न करें.

यह चैनल weekly चैनल पर आधारित है. इसे हफ़्ते में एक बार अपडेट किया जाता है.

आप Maps JavaScript एपीआई को नीचे दिए गए स्क्रिप्ट टैग की मदद से लोड करके, बीटा चैनल के बारे में बता सकते हैं:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=beta
        &key=YOUR_API_KEY&callback=initMap">
</script>

ऐल्फ़ा चैनल चुनना

नई प्रयोग के तौर पर दी गई सुविधाएं और बदलाव आज़माने के लिए, ऐल्फ़ा चैनल का इस्तेमाल करें. कृपया समस्याओं की शिकायत करने और सुझाव देने के लिए, समस्या को ट्रैक करने वाले टूल का इस्तेमाल करें. ऐल्फ़ा चैनल किसी भी सेवा स्तर समझौते (एसएलए) या नीति के दायरे में नहीं आता. साथ ही, हो सकता है कि कुछ बदलाव पिछली रिलीज़ के साथ काम न करें. यह सिर्फ़ डेवलपमेंट के लिए है. प्रोडक्शन में इसका इस्तेमाल नहीं किया जाना चाहिए.

यह चैनल beta चैनल पर आधारित है. इसे हफ़्ते में एक बार अपडेट किया जाता है.

आप Maps JavaScript एपीआई को नीचे दिए गए स्क्रिप्ट टैग के साथ लोड करके ऐल्फ़ा चैनल तय कर सकते हैं:

  <script async
      src="https://maps.googleapis.com/maps/api/js?v=alpha
          &key=YOUR_API_KEY&callback=initMap">
  </script>

वर्शन नंबर चुनना

किसी वर्शन को नंबर के हिसाब से ही तय करें, जब ऐप्लिकेशन का नियमित तौर पर टेस्ट किया जाए और उसे अपडेट किया जाए. इसकी वजह यह है कि हर तिमाही में नए वर्शन बनने के बाद, नंबर वाले वर्शन मिटा दिए जाते हैं. Maps JavaScript एपीआई को नीचे दिए गए स्क्रिप्ट टैग के साथ लोड करके, वर्शन नंबर बताया जा सकता है:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=3.53
        &key=YOUR_API_KEY&callback=initMap">
</script>

फ़िलहाल, v=3.54, v=3.53, v=3.52 या v=3.51 की जानकारी दी जा सकती है.

  • वर्शन 3.54 में हर हफ़्ते नए अपडेट मिलते हैं. साथ ही, इसमें नई सुविधाएं, गड़बड़ियां ठीक की जाती हैं, और परफ़ॉर्मेंस में सुधार किए जाते हैं.
  • वर्शन 3.53 को हर हफ़्ते अपडेट नहीं मिलते.
  • वर्शन 3.52 में हर हफ़्ते अपडेट नहीं मिल रहे हैं.
  • वर्शन 3.51 में हर हफ़्ते अपडेट नहीं मिल रहे हैं.
  • समय-समय पर, हम किसी भी वर्शन में सुरक्षा से जुड़ी गड़बड़ियां ठीक कर सकते हैं.
  • नया वर्शन बनाते समय, हम पुराने सिस्टम के साथ काम न करने वाले बदलाव लागू कर सकते हैं.

नवंबर के बीच में, आपके पास v=3.55, v=3.54, v=3.53 या v=3.52 बताने का विकल्प होगा.

  • वर्शन 3.55 में आपको हर हफ़्ते नए फ़ीचर, गड़बड़ी ठीक करने, और परफ़ॉर्मेंस में सुधार करने के बारे में अपडेट मिलेंगे.
  • वर्शन 3.54 में अब हर हफ़्ते अपडेट नहीं मिलेंगे.
  • वर्शन 3.53 में अब हर हफ़्ते अपडेट नहीं मिलेंगे.
  • वर्शन 3.52 में अब हर हफ़्ते अपडेट नहीं मिलेंगे.
  • समय-समय पर, हम किसी भी वर्शन में सुरक्षा से जुड़ी गड़बड़ियां ठीक कर सकते हैं.
  • वर्शन 3.51 अब उपलब्ध नहीं रहेगा. इस वर्शन को लोड करने की कोशिश नहीं की जाएगी. इसके बजाय, आपको अपना डिफ़ॉल्ट चैनल मिल जाएगा.

नीचे दिया गया डायग्राम दिखाता है कि अगले साल तक हर चैनल पर कौनसे वर्शन उपलब्ध होंगे.

आपको मेरी यह बात गाँठ बाँध लेनी चाहिए कि आप क्रिएटर हैं, इसलिए आप एक आर्टिस्ट हैं और आर्टिस्ट को इंस्पायर्ड होना चाहिए.

एक अपडेट ने मेरे ऐप्लिकेशन को प्रभावित किया

रिलीज़ किए गए चैनलों को अपडेट करने पर, आपके ऐप्लिकेशन पर असर पड़ सकता है. ऐसा तब हो सकता है, जब आपका ऐप्लिकेशन बिना जानकारी वाली या काम न करने वाली सुविधाओं पर निर्भर हो या किसी गड़बड़ी की वजह से हुआ हो या गड़बड़ियां ठीक की गई हों.

अस्थायी समाधान के रूप में, अपने ऐप्लिकेशन को पुराने वर्शन का इस्तेमाल करने के लिए फिर से कॉन्फ़िगर किया जा सकता है.

  1. अपने ब्राउज़र डेवलपर टूल में कंसोल खोलें और google.maps.version की वैल्यू देखें.
  2. एपीआई को लोड करने वाला स्क्रिप्ट टैग अपडेट करें और पुराने वर्शन का अनुरोध करें.
    उदाहरण के लिए, अगर google.maps.version "3.54.2" है, तो अपने स्क्रिप्ट टैग में v=3.53 का इस्तेमाल करें.
    अस्थायी समाधान सिर्फ़ सीमित समय के लिए काम करेगा.

अस्थायी समाधान होने के बाद, आपके पास ऐप्लिकेशन अपडेट करने के लिए (आम तौर पर, तीन से छह महीने) का समय होगा. इसलिए, यह गड़बड़ी या गड़बड़ियां ठीक करने के लिए, बिना पहचान वाली या बिना समर्थन वाली सुविधाओं का इस्तेमाल करता है.

इसके बाद, आपको एपीआई लोड करने के लिए, मूल स्क्रिप्ट टैग पर वापस जाना होगा.

सहायता अनुरोध बनाने या समस्या की शिकायत करने के लिए भी आपका स्वागत है.

तिमाही अपडेट

Maps JavaScript एपीआई टीम हर तीन महीने में एक बार नया वर्शन रिलीज़ करती है. यह फ़रवरी के बीच, अगस्त के मध्य, और अगस्त के मध्य में होता है. अगला अपडेट नवंबर के बीच होगा. नया साप्ताहिक चैनल वर्शन 3.55 उपलब्ध कराएगा और उस समय अन्य चैनल अपडेट किए जाएंगे.

हर हफ़्ते चैनल अपडेट करना

फ़िलहाल, हर हफ़्ते के चैनल पर वर्शन 3.54 का इस्तेमाल किया जा रहा है.

नवंबर के बीच में, हर हफ़्ते के चैनल को वर्शन 3.54 से 3.55 में अपडेट कर दिया जाएगा. ऐसा होने पर, नए वर्शन में नई सुविधाएं, हटाई गई सुविधाएं हटाना, और/या पुराने सिस्टम के साथ काम न करने से जुड़ी सुविधाएं शामिल होंगी. चैनल अपडेट होने पर, आपको इन बदलावों को आज़माना पड़ सकता है.

तिमाही के दौरान, नए वर्शन को हर हफ़्ते अपडेट किया जाएगा. इसमें नई सुविधाएं, गड़बड़ियों को ठीक करना, और परफ़ॉर्मेंस में सुधार करना शामिल है. इससे, बंद की गई सुविधाएं नहीं हटेंगी. साथ ही, यह पुराने सिस्टम के साथ काम करने से जुड़ी सुविधाओं को लागू नहीं करेगी.

चैनल का तिमाही अपडेट

फ़िलहाल, हर तीन महीने में मिलने वाले चैनल पर 3.53 वर्शन मौजूद है.

नवंबर के बीच में, हर तिमाही होने वाले चैनल को वर्शन 3.53 से 3.54 में अपडेट किया जाएगा. अपडेट किए जाने के बाद, इस वर्शन में नई सुविधाएं जोड़ी जाएंगी. साथ ही, काम न करने वाली सुविधाओं को हटाया जाएगा और/या पिछले तीन महीनों के लिए, पुराने सिस्टम के साथ काम करने से जुड़ी समस्याओं की जानकारी दी जाएगी. चैनल अपडेट होने पर, आपको इन बदलावों को आज़माना पड़ सकता है.

इस तिमाही के दौरान, इस वर्शन में नई सुविधाएं, गड़बड़ियां ठीक की गई हैं या परफ़ॉर्मेंस में सुधार नहीं किए जाएंगे. इससे, बंद की गई सुविधाएं नहीं हटेंगी. साथ ही, यह पुराने सिस्टम के साथ काम करने से जुड़ी सुविधाओं को लागू नहीं करेगी.

वर्शन से जुड़े अपडेट

नवंबर के बीच में, वर्शन नंबर रोल आउट होते हैं, ताकि नए वर्शन की रिलीज़ का ध्यान रखा जा सके.

वर्शन 3.55

नया वर्शन 3.55 नवंबर के मध्य में रिलीज़ किया जाएगा. रिलीज़ होने के बाद, इस वर्शन में नई सुविधाएं जोड़ी जाएंगी. साथ ही, काम न करने वाली सुविधाओं को हटाया जाएगा और/या वर्शन 3.54 की तुलना में पुराने सिस्टम के साथ काम नहीं करने की सुविधाएं मिलेंगी. वर्शन नंबरों के बीच बदलते समय, आपको अपने ऐप्लिकेशन की जांच करनी चाहिए.

इस तिमाही के दौरान, इस नए वर्शन को हर हफ़्ते अपडेट किया जाएगा. इसमें, नई सुविधाएं, गड़बड़ी ठीक करने, और परफ़ॉर्मेंस को बेहतर बनाने के तरीके शामिल किए जाएंगे. इससे, बंद की गई सुविधाएं नहीं हटेंगी. साथ ही, यह पुराने सिस्टम के साथ काम करने से जुड़ी सुविधाओं को लागू नहीं करेगी.

वर्शन 3.54

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

नवंबर के बीच के बाद, इस वर्शन को नई सुविधाओं, गड़बड़ी ठीक करने या परफ़ॉर्मेंस को बेहतर बनाने से अपडेट नहीं किया जाएगा. इससे, बंद की गई सुविधाएं नहीं हटेंगी. साथ ही, यह पुराने सिस्टम के साथ काम करने से जुड़ी सुविधाओं को लागू नहीं करेगी.

वर्शन 3.53

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

इस वर्शन को अब नई सुविधाओं, गड़बड़ी ठीक करने या परफ़ॉर्मेंस को बेहतर बनाने से अपडेट नहीं किया जाएगा. ऐसा करने से, इस वर्शन के बाद जिन सुविधाओं को बंद कर दिया जाएगा उन्हें हटाया नहीं जाएगा. साथ ही, पुराने सिस्टम के साथ काम न करने वाली नई सुविधाओं को उपलब्ध नहीं कराया जाएगा.

वर्शन 3.52

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

इस वर्शन को अब नई सुविधाओं, गड़बड़ी ठीक करने या परफ़ॉर्मेंस को बेहतर बनाने से अपडेट नहीं किया जाएगा. ऐसा करने से, इस वर्शन के बाद जिन सुविधाओं को बंद कर दिया जाएगा उन्हें हटाया नहीं जाएगा. साथ ही, पुराने सिस्टम के साथ काम न करने वाली नई सुविधाओं को उपलब्ध नहीं कराया जाएगा.

वर्शन 3.51

नवंबर के मध्य के बाद, यह वर्शन मिटा दिया जाएगा और इसका इस्तेमाल नहीं किया जा सकेगा. इस वर्शन को लोड करने की कोशिश को अनदेखा कर दिया जाएगा और आपको इसकी जगह अपना डिफ़ॉल्ट चैनल मिलेगा.

वर्शन से जुड़ी सहायता

किसी भी तिमाही में चार वर्शन उपलब्ध हैं. ये चारों वर्शन काम करते हैं.

वर्शन की जांच

डीबग करने के लिए, अपने ऐप्लिकेशन में मैप JavaScript एपीआई का मौजूदा वर्शन पाने के लिए, google.maps.version प्रॉपर्टी का इस्तेमाल करें. कोड के इस नमूने का इस्तेमाल करके, ब्राउज़र कंसोल में एपीआई का वर्शन लिखा जाता है. (ब्राउज़र कंसोल के बारे में ज़्यादा जानकारी पाने के लिए, अपने ब्राउज़र में गड़बड़ियों की जांच करना गाइड देखें.)

<!DOCTYPE html>
<html>
  <head>
    <title>Display Google Maps API Version</title>
  </head>
  <body>
    <script>
      function initMap() {
        // Add your map here.
        console.log('Google Maps API version: ' + google.maps.version);
      }
    </script>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
    defer></script>
  </body>
</html>

एपीआई वर्शन के लिए दस्तावेज़

डेवलपर की गाइड हमेशा हफ़्ते के वर्शन के बारे में बताती है.

इसके अलावा, हर वर्शन के लिए एक अलग रेफ़रंस रखा जाता है: