वर्शन

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

बीटा चैनल के बारे में बताने के लिए, Maps JavaScript API को इस स्क्रिप्ट टैग के साथ लोड करें:

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

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

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

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

नीचे दिए गए स्क्रिप्ट टैग की मदद से, Maps JavaScript API को लोड करके ऐल्फ़ा चैनल तय किया जा सकता है:

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

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

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

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

फ़िलहाल, आपके पास v=3.55, v=3.54, v=3.53 या v=3.52 के बारे में बताने का विकल्प है.

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

फ़रवरी के बीच में, v=3.56, v=3.55, v=3.54 या v=3.53 को तय किया जा सकेगा.

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

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

v3.52v3.53v3.53v3.54v3.54v3.54v3.55v3.55v3.55v3.55v3.56v3.56v3.56v3.57v3.57v3.58

किसी अपडेट की वजह से, मेरे ऐप्लिकेशन पर असर पड़ा है

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

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

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

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

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

इसके अलावा, सहायता अनुरोध या समस्या की शिकायत करें भी बनाया जा सकता है.

तीन महीने में एक बार मिलने वाले अपडेट

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

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

हर हफ़्ते वाले चैनल पर, फ़िलहाल 3.55 वर्शन मिलता है.

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

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

चैनल को तीन महीने में एक बार अपडेट करना

तिमाही चैनल फ़िलहाल 3.54 वर्शन पर ले जाता है.

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

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

वर्शन के अपडेट

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

वर्शन 3.56

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

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

वर्शन 3.55

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

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

वर्शन 3.54

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

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

वर्शन 3.53

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

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

वर्शन 3.52

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

वर्शन सहायता

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

वर्शन की जांच

डीबग करने के लिए, अपने ऐप्लिकेशन में Maps JavaScript API का मौजूदा वर्शन पाने के लिए, 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>

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

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

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