نسخه سازی

انتخاب کانال هفتگی

برای اکثر برنامه‌ها، کانال هفتگی را توصیه می‌کنیم. این جدیدترین و به‌روزترین نسخه است و شامل آخرین رفع اشکالات و بهبودهای عملکرد است. می‌توانید کانال هفتگی را با بارگذاری API جاوا اسکریپت Maps با تگ اسکریپت زیر مشخص کنید:

  <script>
    (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
      key: "YOUR_API_KEY",
      v: "weekly",
    });
  </script>
  

در حال حاضر، کانال هفتگی نسخه ۳.۶۳ است. این نسخه به صورت هفتگی با ویژگی‌های جدید، رفع اشکالات و بهبود عملکرد به‌روزرسانی می‌شود.

در اواسط فوریه، کانال هفتگی به نسخه ۳.۶۴ به‌روزرسانی خواهد شد. در آن زمان، نسخه جدید ممکن است ویژگی‌های منسوخ‌شده را حذف کند و/یا ناسازگاری‌های قبلی را معرفی کند.

انتخاب کانال سه ماهه

برخی از برنامه‌ها ممکن است از به‌روزرسانی‌های کمتر اما بزرگ‌تر بهره‌مند شوند، زیرا قابلیت پیش‌بینی بیشتری را فراهم می‌کند. این برنامه‌ها باید از کانال سه‌ماهه استفاده کنند. اگر می‌خواهید رفع اشکالات و بهبود عملکرد در زمان مورد انتظار انجام شود، از این رویکرد استفاده کنید ( به به‌روزرسانی‌های سه‌ماهه مراجعه کنید). می‌توانید کانال سه‌ماهه را با بارگذاری API جاوا اسکریپت Maps با برچسب اسکریپت زیر مشخص کنید:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "quarterly",
  });
  </script>

در حال حاضر، کانال سه‌ماهه، نسخه ۳.۶۲ است. در طول این سه‌ماهه، این نسخه ویژگی‌های جدید، رفع اشکال یا بهبود عملکرد دریافت نمی‌کند. ما ممکن است هر از گاهی، رفع اشکالات امنیتی را در این نسخه اعمال کنیم.

در اواسط فوریه، کانال سه‌ماهه به نسخه ۳.۶۳ به‌روزرسانی خواهد شد. در آن زمان، نسخه جدید شامل ویژگی‌های جدید، حذف ویژگی‌های منسوخ‌شده و/یا معرفی ناسازگاری‌های نسخه‌های قبلی از سه ماه قبل خواهد بود.

انتخاب کانال بتا

از کانال بتا برای امتحان کردن ویژگی‌ها و تغییرات جدید بتا استفاده کنید. ویژگی‌های بتا از نظر ویژگی کامل هستند اما ممکن است برخی مشکلات برجسته داشته باشند (لطفاً از Issue Tracker برای گزارش مشکلات و ارائه بازخورد استفاده کنید). کانال بتا تحت پوشش هیچ SLA یا سیاست منسوخ شدن نیست و برخی از تغییرات ممکن است با نسخه‌های قبلی سازگار نباشند.

این کانال بر اساس کانال weekly است و هفته‌ای یک بار به‌روزرسانی می‌شود.

شما می‌توانید کانال بتا را با بارگذاری API جاوا اسکریپت Maps با تگ اسکریپت زیر مشخص کنید:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "beta",
  });
  </script>

انتخاب کانال آلفا

از کانال آلفا برای امتحان کردن ویژگی‌ها و تغییرات آزمایشی جدید استفاده کنید. لطفاً از ردیاب مشکلات برای گزارش مشکلات و ارائه بازخورد استفاده کنید. کانال آلفا تحت پوشش هیچ SLA یا سیاست منسوخ شدن نیست و برخی از تغییرات ممکن است با نسخه‌های قبلی سازگار نباشند. این فقط برای اهداف توسعه است و نباید در تولید استفاده شود.

این کانال بر اساس کانال beta ساخته شده و هفته‌ای یک بار به‌روزرسانی می‌شود.

شما می‌توانید کانال آلفا را با بارگذاری API جاوا اسکریپت Maps با تگ اسکریپت زیر مشخص کنید:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "alpha",
  });
  </script>

انتخاب شماره نسخه

فقط در صورتی که مرتباً برنامه خود را آزمایش و به‌روزرسانی می‌کنید، نسخه را با شماره مشخص کنید. دلیل این امر این است که نسخه‌های شماره‌گذاری شده در نهایت حذف می‌شوند زیرا نسخه‌های جدید هر سه ماه یکبار ایجاد می‌شوند. می‌توانید شماره نسخه را با بارگذاری API جاوا اسکریپت Maps با برچسب اسکریپت زیر مشخص کنید:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: 3.62,
  });
  </script>

در حال حاضر، می‌توانید v=3.63 ، v=3.62 ، v=3.61 یا v=3.60 را مشخص کنید.

• نسخه ۳.۶۳ به‌روزرسانی‌های هفتگی با ویژگی‌های جدید، رفع اشکالات و بهبود عملکرد دریافت می‌کند.
• نسخه ۳.۶۲ به‌روزرسانی‌های هفتگی دریافت نمی‌کند.
• نسخه ۳.۶۱ به‌روزرسانی‌های هفتگی دریافت نمی‌کند.
• نسخه ۳.۶۰ به‌روزرسانی‌های هفتگی دریافت نمی‌کند.
• ما ممکن است هر از گاهی، اصلاحات امنیتی را در هر نسخه‌ای ارائه دهیم.
• ممکن است هنگام ایجاد نسخه جدید، تغییراتی را اعمال کنیم که با نسخه‌های قبلی سازگار نباشند.

بعد از اواسط فوریه، می‌توانید v=3.64 ، v=3.63 ، v=3.62 یا v=3.61 را مشخص کنید.

• نسخه ۳.۶۴ به‌روزرسانی‌های هفتگی با ویژگی‌های جدید، رفع اشکالات و بهبود عملکرد دریافت خواهد کرد.
• نسخه ۳.۶۳ دیگر به‌روزرسانی‌های هفتگی دریافت نخواهد کرد.
• نسخه ۳.۶۲ دیگر به‌روزرسانی‌های هفتگی دریافت نخواهد کرد.
• نسخه ۳.۶۱ دیگر به‌روزرسانی‌های هفتگی دریافت نخواهد کرد.
• ما ممکن است هر از گاهی، اصلاحات امنیتی را در هر نسخه‌ای ارائه دهیم.
• نسخه ۳.۶۰ دیگر در دسترس نخواهد بود. هرگونه تلاشی برای بارگیری این نسخه نادیده گرفته می‌شود و به جای آن کانال پیش‌فرض خود را دریافت خواهید کرد.

نمودار زیر نشان می‌دهد که کدام نسخه‌ها در هر کانال در طول سال آینده در دسترس خواهند بود.

یک به‌روزرسانی روی برنامه من تأثیر گذاشت

وقتی کانال‌های انتشار را به‌روزرسانی می‌کنیم، می‌تواند روی برنامه شما تأثیر بگذارد. این می‌تواند به این دلیل رخ دهد که برنامه شما به ویژگی‌های مستند نشده یا منسوخ شده متکی است، یا به دلیل یک اشکال یا رفع اشکالی که ما معرفی کرده‌ایم.

به عنوان یک راه حل موقت، می‌توانید برنامه خود را برای استفاده از نسخه قدیمی‌تر پیکربندی مجدد کنید.

1. کنسول را در ابزارهای توسعه‌دهنده مرورگر خود باز کنید و به مقدار google.maps.version نگاه کنید.
2. تگ اسکریپتی که API را بارگذاری می‌کند به‌روزرسانی کنید و شماره نسخه قدیمی‌تر را درخواست کنید .
   برای مثال، اگر google.maps.version برابر با "3.63.2" است، v=3.62 در تگ اسکریپت خود استفاده کنید.
   این راه حل موقت فقط برای مدت محدودی کار خواهد کرد.

پس از پیاده‌سازی راه‌حل موقت، شما زمان (معمولاً ۳ تا ۶ ماه) برای به‌روزرسانی برنامه خود خواهید داشت، به طوری که دیگر از ویژگی‌های مستند نشده یا منسوخ شده استفاده نکند و اشکالات یا رفع اشکالات را نیز در نظر بگیرد.

سپس باید برای بارگذاری API به تگ اسکریپت اصلی برگردید.

همچنین می‌توانید یک پرونده پشتیبانی ایجاد کنید یا مشکلی را گزارش دهید .

به‌روزرسانی‌های فصلی

هر سه ماه یک بار، تیم Maps JavaScript API نسخه جدیدی منتشر می‌کند. این اتفاق در اواسط فوریه، اواسط مه، اواسط آگوست و اواسط نوامبر رخ می‌دهد. به‌روزرسانی بعدی اواسط فوریه خواهد بود. کانال هفتگی جدید نسخه ۳.۶۴ را ارائه خواهد کرد و در آن زمان سایر کانال‌ها به‌روزرسانی می‌شوند.