版本控制

选择每周渠道

对于大多数应用，建议使用每周渠道。此渠道提供的版本是最新的，包含最新的 bug 修复和性能提升。您可以使用以下脚本标记来加载 Maps JavaScript API，从而指定每周渠道：

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

目前，每周渠道提供的是版本 3.58。此版本每周更新一次，以加入新功能、修复 bug 并提升性能。

11 月中旬，每周渠道提供的版本将更新至版本 3.59。届时，新版本可能会移除已弃用的功能，并/或引入向后不兼容性。

选择季度渠道

某些应用可能更适合进行数量较少但规模较大的更新，因为这会提高可预测性。这些应用应使用季度渠道。如果您希望在预期的时间修复 bug 和提升性能，请使用此方法（请参阅季度更新）。您可以使用以下脚本标记来加载 Maps JavaScript API，从而指定季度渠道：

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

目前，季度渠道提供的版本为版本 3.57。在本季度，此版本将不再接收新功能、bug 修复或性能提升。我们可能会不时地在此版本中引入安全性 bug 修复。

11 月中旬，季度渠道提供的版本将更新至版本 3.58。届时，新版本将加入新功能、移除已弃用的功能并/或不再向后兼容前三个月的功能。

选择 Beta 渠道

使用 Beta 渠道可以试用新的 Beta 版功能和变更。Beta 版有完整的功能，但可能存在一些未解决的问题（请使用问题跟踪器报告问题并提供反馈）。Beta 渠道不在任何服务等级协议 (SLA) 或弃用政策的涵盖范围内，并且某些变更可能无法向后兼容早期版本。

此渠道基于 weekly 渠道，每周更新一次。

您可以使用以下脚本标记来加载 Maps JavaScript API，从而指定 Beta 渠道：

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

选择 Alpha 渠道

使用 Alpha 渠道可以试用新的实验性功能和变更。请使用问题跟踪器报告问题并提供反馈。Alpha 渠道不在任何服务等级协议 (SLA) 或弃用政策的涵盖范围内，并且某些变更可能无法向后兼容早期版本。此渠道仅用于开发目的，不应在生产环境中使用。

此渠道基于 beta 渠道，每周更新一次。

您可以使用以下脚本标记来加载 Maps JavaScript API，从而指定 Alpha 渠道：

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

选择版本号

请仅在定期测试并更新应用的情况下才通过编号指定版本。这是因为随着新版本在每个季度中一一创建，编号版本最终会被删除。您可以使用以下脚本标记来加载 Maps JavaScript API，从而指定版本号：

  <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.57,
  });
  </script>

目前，您可以指定 v=3.58、v=3.57、v=3.56 或 v=3.55。

• 版本 3.58 将接收每周更新，其中包含新功能、bug 修复和性能提升。
• 版本 3.57 不会接收每周更新。
• 版本 3.56 不会接收每周更新。
• 版本 3.55 不会接收每周更新。
• 我们可能会不时地在任何版本中引入安全性 bug 修复。
• 在创建新版本时，我们可能会引入向后不兼容的变更。

11 月中旬之后，您将能够指定 v=3.59、v=3.58、v=3.57 或 v=3.56。

• 版本 3.59 将接收每周更新，其中包含新功能、bug 修复和性能提升。
• 版本 3.58 将不再接收每周更新。
• 版本 3.57 将不再接收每周更新。
• 版本 3.56 将不再接收每周更新。
• 我们可能会不时地在任何版本中引入安全性 bug 修复。
• 版本 3.55 将无法再使用。任何尝试加载此版本的操作都将被忽略，系统将改而为您采用默认的渠道。

下图显示了在未来一年内每个渠道将会提供的版本。

季度更新

Maps JavaScript API 团队会每季度发布一个新版本，时间分别在 2 月中旬、5 月中旬、8 月中旬和 11 月中旬。下一次更新时间为 11 月中旬。新的每周渠道将提供版本 3.59，届时其他渠道也会进行更新。