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.52, v=3.51, v=3.50 ou v=3.49.
  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 de script:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=weekly
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

Em meados de abril, o canal semanal será atualizado para a versão 3.53, 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 de script:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=quarterly
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

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

Recomendamos que você teste seu aplicativo no início de abril usando v=3.52.

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 async
    src="https://maps.googleapis.com/maps/api/js?v=beta
        &key=YOUR_API_KEY&callback=initMap">
</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 async
      src="https://maps.googleapis.com/maps/api/js?v=alpha
          &key=YOUR_API_KEY&callback=initMap">
  </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 async
    src="https://maps.googleapis.com/maps/api/js?v=3.51
        &key=YOUR_API_KEY&callback=initMap">
</script>

No momento, é possível especificar v=3.52, v=3.51, v=3.50 ou v=3.49.

• A versão 3.52 está recebendo atualizações semanais com novos recursos, correções de bugs e melhorias na performance.
• A versão 3.51 não está recebendo atualizações semanais.
• A versão 3.50 não está recebendo atualizações semanais.
• A versão 3.49 não está recebendo atualizações semanais.
• De tempos em tempos, fazemos correções de bugs de segurança em todas as versões.
• Quando criamos uma versão, é possível que ocorra a inclusão de mudanças incompatíveis com versões anteriores.

A partir de meados de abril, você poderá especificar v=3.53, v=3.52, v=3.51 ou v=3.50.

• A versão 3.53 vai receber atualizações semanais com novos recursos, correções de bugs e melhorias na performance.
• A versão 3.52 não vai mais receber atualizações semanais.
• A versão 3.51 não vai mais receber atualizações semanais.
• A versão 3.50 não vai mais receber atualizações semanais.
• De tempos em tempos, fazemos correções de bugs de segurança em todas as versões.
• A versão 3.49 não vai mais estar disponível. Qualquer tentativa de carregar essa versão será ignorada, e você vai receber o canal padrão.

Se você estiver usando v=3.50 ou v=3.49, recomendamos fazer upgrade para v=3.52 ou v=3.51 até meados de abril. Ao trocar de versão, saiba que as opções mais recentes podem remover recursos descontinuados e/ou introduzir incompatibilidades com versões anteriores.

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.52.2", use v=3.51 na sua 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 abril. O novo canal semanal vai disponibilizar a versão 3.53, e os outros canais serão atualizados.

Teste os aplicativos regularmente para determinar se a nova versão ou as atualizações dos últimos três meses causaram problemas que precisam ser resolvidos. Para isso, configure uma instância de teste do aplicativo ou crie um ambiente de preparo/desenvolvimento especificamente para testes.

Atualização do canal semanal

Atualmente, o canal semanal está na versão 3.52.

Em meados de abril, esse canal será atualizado da versão 3.52 para a 3.53, que provavelmente vai incluir novos recursos, remover os descontinuados e/ou introduzir incompatibilidades com versões anteriores. Talvez seja preciso testar essas mudanças quando o canal for atualizado.

Ao longo do trimestre, a nova versão será atualizada semanalmente com novos recursos, correções de bugs e melhorias na performance. Ela não remove recursos descontinuados nem introduz incompatibilidades com versões anteriores.

Atualização do canal trimestral

Atualmente, o canal trimestral está na versão 3.51.

Em meados de abril, o canal trimestral será atualizado da versão 3.51 para a versão 3.52, que provavelmente vai incluir novos recursos, remover os descontinuados e/ou introduzir incompatibilidades com versões anteriores referentes aos últimos três meses. Talvez seja preciso testar essas mudanças quando o canal for atualizado.

Ao longo do trimestre, essa nova versão vai incluir novos recursos, correções de bugs ou melhorias na performance. Ela não remove recursos descontinuados nem introduz incompatibilidades com versões anteriores.

Atualizações da versão

Em meados de abril, os números das versões vão mudar para refletir o lançamento de uma nova versão.

Versão 3.53

Uma nova versão 3.53 será lançada em meados de abril e provavelmente vai incluir novos recursos, remover os descontinuados e/ou introduzir incompatibilidades com versões anteriores em comparação com a versão 3.52. Teste o aplicativo ao mudar de versão.

Durante o trimestre, a nova versão será atualizada semanalmente com novos recursos, correções de bugs e melhorias na performance. Ela não remove recursos descontinuados nem introduz incompatibilidades com versões anteriores.

Versão 3.52

Esta versão inclui novos recursos, remove os descontinuados e/ou introduz incompatibilidades com versões anteriores em comparação com a versão 3.51. Teste o aplicativo ao mudar de versão.

Após meados de abril, essa versão não será mais atualizada com novos recursos, correções de bugs ou melhorias na performance. Ela não remove recursos descontinuados nem introduz incompatibilidades com versões anteriores.

Versão 3.51

Esta versão inclui novos recursos, remove os descontinuados e/ou introduz incompatibilidades com versões anteriores em comparação com a versão 3.50. Teste o aplicativo ao mudar de versão.

Ela não será mais atualizada com novos recursos, correções de bugs ou melhorias na performance, além de não remover recursos descontinuados após essa versão nem adicionar novas incompatibilidades com versões anteriores.

Versão 3.50

Esta versão inclui novos recursos, remove os descontinuados e/ou introduz incompatibilidades com versões anteriores em comparação com a versão 3.49. Teste o aplicativo ao mudar de versão.

Ela não será mais atualizada com novos recursos, correções de bugs ou melhorias na performance, além de não remover recursos descontinuados após essa versão nem adicionar novas incompatibilidades com versões anteriores.

Versão 3.49

Após meados de abril, essa versão será excluída e não vai mais poder ser usada. Qualquer tentativa de carregar essa versão será ignorada, e você vai receber o canal padrão.

Compatibilidade das versões

Há sempre quatro versões disponíveis em qualquer trimestre. Essas quatro versões são têm suporte.

Verificações das versões

Se quiser fazer a depuração, use a propriedade google.maps.version para conseguir a versão atual da API Maps JavaScript no seu aplicativo. O código a seguir escreve a versão da API no console do navegador. Para mais informações sobre o console, consulte o guia sobre verificação de erros no seu navegador.

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

Documentação das versões de API

O Guia para desenvolvedores sempre descreve a versão semanal.

Além disso, uma referência para cada versão é mantida separadamente:

• Referência da API versão 3.52 (canal semanal)
• Referência da API versão 3.51 (canal trimestral)
• Referência da API versão 3.50
• Referência da API versão 3.49
• As versões 3.0 a 3.48 foram excluídas.