Controle de versões

A equipe da API Maps JavaScript atualiza a API regularmente com novos recursos, correções de bugs e melhorias na performance. Nesta página, descrevemos as versões da API disponíveis para uso nos aplicativos.

Canais de lançamento e números de versão

No seu aplicativo, você pode especificar canais de lançamento ou números de versão:

  • O canal semanal é especificado com v=weekly.
    Ele é atualizado uma vez por semana e é o mais atual.
  • O canal trimestral é especificado com v=quarterly.
    Ele é atualizado uma vez por trimestre e é o mais previsível.
  • O canal Beta é especificado com v=beta.
    Ele tem como base o canal weekly, é atualizado uma vez por semana e inclui outras mudanças para testes iniciais e feedback.
  • O Canal Alfa é especificado com v=alpha.
    Ele tem como base o canal beta e é atualizado uma vez por semana. Esse canal inclui experimentos para os clientes darem feedback sobre protótipos. Ele serve apenas para desenvolvimento e não deve ser usado na produção.
  • O número da versão é especificado com v=n.nn.
    Escolha v=3.62, v=3.61, v=3.60 ou v=3.59.
    Ele é atualizado uma vez por trimestre (consulte Atualizações trimestrais).

Quando você não especifica um canal ou uma versão, recebe o canal semanal por padrão. Se você migrou do Plano Premium e não especificou um canal ou uma versão, vai receber o canal trimestral por padrão. Caso a versão especificada seja inválida, o canal padrão será enviado.

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.62. 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.63, 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>

No momento, a versão do canal trimestral é a 3.61. 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.62. 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.61,
  });
  </script>

No momento, é possível especificar v=3.62, v=3.61, v=3.60 ou v=3.59.

  • A versão 3.62 está recebendo atualizações semanais com novos recursos, correções de bugs e melhorias na performance.
  • A versão 3.61 não está recebendo atualizações semanais.
  • A versão 3.60 não está recebendo atualizações semanais.
  • A versão 3.59 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.63, v=3.62, v=3.61 ou v=3.60.

  • A versão 3.63 vai receber atualizações semanais com novos recursos, correções de bugs e melhorias na performance.
  • A versão 3.62 não vai mais receber atualizações semanais.
  • A versão 3.61 não vai mais receber atualizações semanais.
  • A versão 3.60 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.59 não vai mais estar 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.

v=weekly v=quarterly v=3.nn
v=3.nn-1 Aug 2025 Nov 2025 Feb 2026 May 2026 v3.59 v3.60 v3.60 v3.61 v3.61 v3.61 v3.62 v3.62 v3.62 v3.62 v3.63 v3.63 v3.63 v3.64 v3.64 v3.65