Controle de versões

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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 número da versão é especificado com v=n.nn.
    Escolha v=3.50, v=3.49, v=3.48 ou v=3.47.
    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.50. Ela é atualizada toda semana com novos recursos, correções de bugs e melhorias na performance.

Em meados de novembro, o canal semanal passará para a versão 3.51, 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.49. Ela não recebe novos recursos, correções de bugs ou melhorias na performance durante o trimestre. De tempos em tempos, introduzimos correções de bugs de segurança na versão.

Em meados de novembro, o canal trimestral será atualizado para a versão 3.50, 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 async
    src="https://maps.googleapis.com/maps/api/js?v=beta
        &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.49
        &key=YOUR_API_KEY&callback=initMap">
</script>

No momento, é possível especificar v=3.50, v=3.49, v=3.48 ou v=3.47.

  • A versão 3.50 está recebendo atualizações semanais com novos recursos, correções de bugs e melhorias na performance.
  • A versão 3.49 não está recebendo atualizações semanais.
  • A versão 3.48 não está recebendo atualizações semanais.
  • A versão 3.47 não está recebendo atualizações semanais.
  • De tempos em tempos, introduzimos correções de bugs de segurança em todas as versões.
  • 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.51, v=3.50, v=3.49 ou v=3.48.

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

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

v=semanal v=trimestral v=3.nn v=3.nn-1 Ago/2022 Nov/2022 Fev/2023 Mai/2023 v3.47 v3.48 v3.48 v3.49 v3.49 v3.49 v3.50 v3.50 v3.50 v3.50 v3.51 v3.51 v3.51 v3.52 v3.52 v3.53

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.50.2", use v=3.49 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.51, e os outros canais serão atualizados.

Atualização semanal do canal

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

Em meados de novembro, ele será atualizado para a versão 3.51, 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 vai remover recursos descontinuados nem introduzir incompatibilidades com versões anteriores.

Atualização trimestral do canal

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

Em meados de novembro, ele será atualizado para a versão 3.50, 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 vai remover recursos descontinuados nem introduzir incompatibilidades com versões anteriores.

Atualizações da versão

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

Versão 3.51

A nova versão 3.51, que será lançada em meados de novembro, provavelmente vai incluir novos recursos, remover os descontinuados e/ou introduzir incompatibilidades com versões anteriores em comparação com a versão 3.50. 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 vai remover recursos descontinuados nem introduzir 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.

Após meados de novembro, esta versão não será mais atualizada com novos recursos, correções de bugs ou melhorias na performance. Ela não vai remover recursos descontinuados nem introduzir incompatibilidades com versões anteriores.

Versão 3.49

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

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

Após meados de novembro, esta versão será excluída e não poderá mais ser usada. Qualquer tentativa de carregar esta 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: