Controle de versões

Escolher o canal semanal

Recomendamos o canal semanal para a maioria dos aplicativos. É a versão mais atualizada e contém as últimas correções de bugs e melhorias na performance. Para especificar o canal semanal, carregue a API Maps JavaScript com a seguinte tag script:

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

No momento, a versão do canal semanal é a 3.58. Ela é atualizada toda semana com novos recursos, correções de bugs e melhorias na performance.

Em meados de novembro, o canal semanal será atualizado para a versão 3.59, que provavelmente vai remover recursos descontinuados e/ou introduzir incompatibilidades com versões anteriores.

Escolher o canal trimestral

Alguns aplicativos, que se beneficiam de atualizações maiores e em menor quantidade porque oferecem maior previsibilidade, devem usar o canal trimestral. Use essa abordagem se quiser receber correções de bugs e melhorias na performance em um período definido (consulte as atualizações trimestrais). Para especificar o canal trimestral, carregue a API Maps JavaScript com a seguinte tag script:

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

Atualmente, a versão do canal trimestral é a 3.57. que não recebe novos recursos, correções de bugs ou melhorias na performance durante o trimestre. Fazemos correções de bugs de segurança na versão periodicamente.

Em meados de novembro, o canal trimestral será atualizado para a versão 3.58, que provavelmente vai incluir novos recursos, remover os descontinuados e/ou introduzir incompatibilidades com versões anteriores referentes aos últimos três meses.

Escolher o canal Beta

Use esse canal para testar novos recursos e mudanças da versão Beta. Os recursos Beta são completos, mas podem ter alguns problemas. Use o Issue Tracker para informar erros e enviar feedback. Nenhum SLA ou política de descontinuação abrange o canal Beta, e algumas alterações podem ser incompatíveis com versões anteriores.

Ele tem como base o canal weekly e é atualizado uma vez por semana.

Para especificar o canal Beta, carregue a API Maps JavaScript com a seguinte tag de script:

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

Escolher o Canal Alfa

Use o Canal Alfa para testar novos recursos e mudanças experimentais. Use o Issue Tracker para informar problemas e enviar feedback. Nenhum SLA ou política de descontinuação abrange o Canal Alfa, e algumas mudanças podem ser incompatíveis com versões anteriores. Ele serve apenas para desenvolvimento e não deve ser usado na produção.

Ele tem como base o Canal beta e é atualizado uma vez por semana.

Para especificar o Canal Alfa, carregue a API Maps JavaScript com a seguinte tag de script:

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

Escolher um número de versão

Especifique uma versão por número apenas se você testar e atualizar o aplicativo regularmente. Isso porque as versões numeradas são excluídas à medida que novas versões são criadas a cada trimestre. Para especificar o número da versão, carregue a API Maps JavaScript com a seguinte tag de script:

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

No momento, é possível especificar v=3.58, v=3.57, v=3.56 ou v=3.55.

• A versão 3.58 está recebendo atualizações semanais com novos recursos, correções de bugs e melhorias na performance.
• A versão 3.57 não está recebendo atualizações semanais.
• A versão 3.56 não está recebendo atualizações semanais.
• A versão 3.55 não está recebendo atualizações semanais.
• Fazemos correções de bugs de segurança em todas as versões periodicamente.
• Ao criar uma nova versão, é possível incluir mudanças incompatíveis com versões anteriores.

A partir da metade de novembro, você poderá especificar v=3.59, v=3.58, v=3.57 ou v=3.56.

• A versão 3.59 vai receber atualizações semanais com novos recursos, correções de bugs e melhorias na performance.
• A versão 3.58 não vai mais receber atualizações semanais.
• A versão 3.57 não vai mais receber atualizações semanais.
• A versão 3.56 não vai mais receber atualizações semanais.
• Fazemos correções de bugs de segurança em todas as versões periodicamente.
• A versão 3.55 não estará mais disponível. Qualquer tentativa de carregar essa versão será ignorada, e você vai receber o canal padrão.

O diagrama abaixo mostra as versões que vão estar disponíveis em cada canal no próximo ano.

Uma atualização afetou meu aplicativo

As atualizações dos canais de lançamento podem afetar seu aplicativo. Isso ocorre porque ele depende de recursos não documentados ou descontinuados, devido a um bug ou a uma correção de bug que introduzimos.

Como solução temporária, reconfigure o aplicativo para usar uma versão mais antiga.

1. Abra o console nas ferramentas para desenvolvedores do navegador e confira o valor da google.maps.version.
2. Atualize a tag do script que carrega a API e solicite um número de versão mais antigo.
   Por exemplo, se google.maps.version for "3.58.2", use v=3.57 na tag de script.
   Essa solução temporária funciona por tempo limitado.

Enquanto ela estiver em vigor, você terá tempo (normalmente de três a seis meses) para atualizar o aplicativo. Assim, ele não vai mais usar recursos não documentados ou descontinuados e vai considerar bugs ou correções de bugs.

Depois, reverta para a tag de script original e carregue a API.

Também é possível criar um caso de suporte ou informar um problema.

Atualizações trimestrais

Uma vez por trimestre, a equipe da API Maps JavaScript lança uma nova versão. Isso ocorre em meados de fevereiro, de maio, de agosto e de novembro. A próxima atualização será em meados de novembro. O novo canal semanal vai disponibilizar a versão 3.59, e os outros canais serão atualizados.