نسخه سازی

تیم API جاوا اسکریپت Maps مرتباً API را با ویژگی‌های جدید، رفع اشکالات و بهبود عملکرد به‌روزرسانی می‌کند. این صفحه نسخه‌های API موجود برای استفاده در برنامه‌های شما را شرح می‌دهد.

کانال‌های انتشار و شماره نسخه‌ها

در برنامه خود می‌توانید کانال‌های انتشار یا شماره نسخه‌ها را مشخص کنید:

  • کانال هفتگی با v=weekly مشخص شده است.
    این کانال هفته‌ای یک بار به‌روزرسانی می‌شود و به‌روزترین کانال است.
  • کانال سه ماهه با v=quarterly مشخص شده است.
    این کانال هر سه ماه یک بار به‌روزرسانی می‌شود و قابل پیش‌بینی‌ترین کانال است.
  • کانال بتا با v=beta مشخص شده است.
    این کانال بر اساس کانال weekly است و هفته‌ای یک بار به‌روزرسانی می‌شود. این کانال شامل تغییرات اضافی برای آزمایش اولیه و دریافت بازخورد است.
  • کانال آلفا با v=alpha مشخص می‌شود.
    این کانال بر اساس کانال beta ساخته شده و هفته‌ای یک بار به‌روزرسانی می‌شود. این کانال شامل آزمایش‌هایی برای دریافت بازخورد مشتری در مورد نمونه‌های اولیه است. این کانال فقط برای اهداف توسعه است و نباید در مرحله تولید استفاده شود.
  • شماره نسخه با v=n.nn مشخص شده است.
    می‌توانید v=3.63 ، v=3.62 ، v=3.61 یا v=3.60 را انتخاب کنید.
    شماره نسخه‌ها هر سه ماه یکبار به‌روزرسانی می‌شوند (به به‌روزرسانی‌های سه‌ماهه مراجعه کنید).

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

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

برای اکثر برنامه‌ها، کانال هفتگی را توصیه می‌کنیم. این جدیدترین و به‌روزترین نسخه است و شامل آخرین رفع اشکالات و بهبودهای عملکرد است. می‌توانید کانال هفتگی را با بارگذاری 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 را مشخص کنید.

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

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

v=هفتگی v=سه‌ماهه v=3.nn v=3.nn-1 نوامبر ۲۰۲۵ فوریه ۲۰۲۶ مه ۲۰۲۶ اوت ۲۰۲۶ نسخه ۳.۶۰ نسخه ۳.۶۱ نسخه ۳.۶۱ نسخه ۳.۶۲ نسخه ۳.۶۲ نسخه ۳.۶۲ نسخه ۳.۶۳ نسخه ۳.۶۳ نسخه ۳.۶۳ نسخه ۳.۶۳ نسخه ۳.۶۴ نسخه ۳.۶۴ نسخه ۳.۶۴ نسخه ۳.۶۵ نسخه ۳.۶۵ نسخه ۳.۶۶

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

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

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

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

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

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

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

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

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

به‌روزرسانی هفتگی کانال

کانال هفتگی در حال حاضر به نسخه ۳.۶۳ اشاره می‌کند.

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

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

به‌روزرسانی سه‌ماهه کانال

کانال سه ماهه در حال حاضر به نسخه ۳.۶۲ اشاره می‌کند.

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

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

به‌روزرسانی‌های نسخه

در اواسط فوریه، شماره نسخه‌ها تغییر می‌کند تا با انتشار نسخه جدید سازگار شود.

نسخه ۳.۶۴

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

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

نسخه ۳.۶۳

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

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

نسخه ۳.۶۲

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

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

نسخه ۳.۶۱

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

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

نسخه ۳.۶۰

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

پشتیبانی از نسخه

در هر سه ماهه، چهار نسخه موجود است. هر چهار نسخه پشتیبانی می‌شوند.

بررسی نسخه‌ها

برای اشکال‌زدایی، از ویژگی google.maps.version برای دریافت نسخه فعلی API جاوا اسکریپت Maps در برنامه خود استفاده کنید. نمونه کد زیر نسخه API را در کنسول مرورگر می‌نویسد. (برای اطلاعات بیشتر در مورد کنسول مرورگر، به راهنمای بررسی خطاها در مرورگر خود مراجعه کنید.)

<!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>

مستندات مربوط به نسخه‌های API

راهنمای توسعه‌دهنده همیشه نسخه هفتگی را شرح می‌دهد.

علاوه بر این، برای هر نسخه یک مرجع جداگانه نگهداری می‌شود: