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 no desempenho. Nesta página, descrevemos as versões da API disponíveis para uso nos aplicativos.

Canais de lançamento e números de versões

No aplicativo, é possível especificar canais de lançamento ou números de versão:

  • O canal semanal é especificado com v=weekly.
    Este canal é atualizado uma vez por semana e é o mais atual.
  • O canal trimestral é especificado com v=quarterly.
    Este canal é atualizado uma vez a cada trimestre e é o mais previsível.
  • O canal Beta é especificado com v=beta.
    Este canal é baseado no canal weekly e é atualizado uma vez por semana. Ele inclui outras alterações para testes e feedback antecipados.
  • O número da versão é especificado com v=n.nn.
    Você pode escolher v=3.50, v=3.49, v=3.48 ou v=3.47.
    Os números das versões são atualizados uma vez por trimestre (consulte Atualizações trimestrais).

Se você não especificar explicitamente um canal ou uma versão, você receberá o canal semanal por padrão. Se você tiver migrado do plano premium e não especificar explicitamente um canal ou uma versão, você receberá o canal trimestral por padrão. Se você especificar uma versão inválida, receberá seu canal padrão.

Escolher o canal semanal

Para a maioria das inscrições, recomendamos o canal semanal. Essa é a versão mais atual e atualizada e contém as correções de bugs e melhorias de desempenho mais recentes. Você pode especificar o canal semanal carregando 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, o canal semanal é a 3.50. Esta versão é atualizada semanalmente com novos recursos, correções de bugs e melhorias de desempenho.

Em meados de novembro, o canal semanal será atualizado para a versão 3.51. Nesse momento, a nova versão pode remover recursos descontinuados e/ou introduzir incompatibilidades de versões anteriores.

Escolher o canal trimestral

Alguns aplicativos podem se beneficiar de menos atualizações, mas maiores, porque oferecem maior previsibilidade. Essas inscrições devem usar o canal do trimestre. Use essa abordagem se você quiser que as correções de bugs e as melhorias de desempenho cheguem em um horário esperado (consulte as atualizações trimestrais). Você pode especificar o canal trimestral carregando 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, o canal trimestral é a versão 3.49. Durante o trimestre, esta versão não recebe novos recursos, correções de bugs ou melhorias de desempenho. Periodicamente, poderemos introduzir correções de bugs de segurança nesta versão.

Em meados de novembro, o canal trimestral será atualizado para a versão 3.50. Nesse momento, a nova versão incluirá novos recursos, removerá recursos descontinuados e/ou introduzirá incompatibilidades de versões anteriores nos três meses anteriores.

Como escolher o Canal Beta

Use o Canal Beta para testar novos recursos e mudanças da versão Beta. Os recursos Beta são completos e podem apresentar alguns problemas pendentes. Use o Issue Tracker para informar problemas e enviar feedback. O canal Beta não é coberto por nenhum SLA ou política de descontinuação, e algumas alterações podem não ser compatíveis com versões anteriores em versões anteriores.

Esse canal é baseado no canal weekly e é atualizado uma vez por semana.

Você pode especificar o canal Beta carregando 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>

Como escolher um número de versão

Especifique uma versão por número apenas se você testar e atualizar o aplicativo regularmente. Isso ocorre porque as versões numeradas são excluídas conforme as novas versões são criadas a cada trimestre. Você pode especificar o número da versão ao carregar 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 de desempenho.
  • 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.
  • Periodicamente, podemos incluir correções de bugs de segurança em qualquer versão.
  • Podemos incluir alterações incompatíveis com versões anteriores ao criar uma nova versão.

A partir da metade de novembro, será possível especificar v=3.51, v=3.50, v=3.49 ou v=3.48.

  • A versão 3.51 receberá atualizações semanais com novos recursos, correções de bugs e melhorias de desempenho.
  • A versão 3.50 não receberá mais atualizações semanais.
  • A versão 3.49 não receberá mais atualizações semanais.
  • A versão 3.48 não receberá mais atualizações semanais.
  • Periodicamente, podemos incluir correções de bugs de segurança em qualquer versão.
  • A versão 3.47 não estará mais disponível. Qualquer tentativa de carregar esta versão será ignorada, e você receberá o canal padrão.

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

As taxas e taxas pautadas pelas taxas {/1}{0} {/1}do {/1}"

Uma atualização afetou minha inscrição

Quando atualizamos os canais de lançamento, isso pode afetar seu aplicativo. Isso pode ocorrer porque seu aplicativo depende de recursos não documentados ou descontinuados ou devido a um bug ou a uma correção de bug que introduzimos.

Como solução temporária, você pode reconfigurar seu aplicativo para usar uma versão mais antiga.

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

Quando a solução temporária estiver em vigor, você terá tempo (normalmente de três a seis meses) para atualizar seu aplicativo, para que ele não use mais recursos não documentados ou descontinuados e seja considerado para bugs ou correções de bugs.

Em seguida, reverta para a tag de script original para carregar 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, meados de maio, meados de agosto e meados de novembro. A próxima atualização será em meados de novembro. O novo canal semanal fornecerá a versão 3.51 e, a partir de então, os outros canais serão atualizados.

Atualização semanal do canal

No momento, o canal semanal aponta para a versão 3.50.

Em meados de novembro, o canal semanal será atualizado da versão 3.50 para a 3.51. Neste ponto, a nova versão vai incluir novos recursos, remover recursos descontinuados e/ou introduzir incompatibilidades de versões anteriores. Talvez seja necessário 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 no desempenho. Ela não removerá recursos descontinuados e não introduzirá incompatibilidades de versões anteriores.

Atualização trimestral do canal

O canal trimestral atualmente aponta para a versão 3.49.

Em meados de novembro, o canal trimestral será atualizado da versão 3.49 para a versão 3.50. Após a atualização, esta versão vai incluir novos recursos, remover recursos descontinuados e/ou introduzir incompatibilidades de versões anteriores nos três meses anteriores. Talvez seja necessário testar essas mudanças quando o canal for atualizado.

Ao longo do trimestre, esta versão não incluirá novos recursos, correções de bugs ou melhorias de desempenho. Ela não removerá recursos descontinuados e não introduzirá incompatibilidades de versões anteriores.

Atualizações da versão

Em meados de novembro, os números das versões serão acumulados para acomodar o lançamento de uma nova versão.

Versão 3.51

Uma nova versão 3.51 será lançada em meados de novembro. Após o lançamento, esta versão incluirá novos recursos, removerá recursos descontinuados e/ou introduz incompatibilidades de versões anteriores em comparação com a versão 3.50. Teste o aplicativo ao mudar de número de versão.

Durante o trimestre, a nova versão será atualizada semanalmente com novos recursos, correções de bugs e melhorias de desempenho. Ela não removerá recursos descontinuados e não introduzirá incompatibilidades de versões anteriores.

Versão 3.50

Essa versão inclui novos recursos, remove recursos descontinuados e/ou introduz incompatibilidades de retorno em comparação com a versão 3.49. Teste o aplicativo ao mudar de número de versão.

A partir da metade de novembro, esta versão não será mais atualizada com novos recursos, correções de bugs ou melhorias no desempenho. Ela não removerá recursos descontinuados e não introduzirá incompatibilidades de versões anteriores.

Versão 3.49

Essa versão inclui novos recursos, remove recursos descontinuados e/ou introduz incompatibilidades de versões anteriores em comparação com a versão 3.48. Teste o aplicativo ao mudar de número de versão.

Esta versão não será mais atualizada com novos recursos, correções de bugs ou melhorias no desempenho. Ela não removerá recursos descontinuados após essa versão e não introduzirá novas incompatibilidades de versões anteriores.

Versão 3.48

Essa versão inclui novos recursos, remove recursos descontinuados e/ou introduz incompatibilidades de versões anteriores em comparação com a versão 3.47. Teste o aplicativo ao mudar de número de versão.

Esta versão não será mais atualizada com novos recursos, correções de bugs ou melhorias no desempenho. Ela não removerá recursos descontinuados após essa versão e não introduzirá novas incompatibilidades de 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ê receberá o canal padrão.

Compatibilidade das versões

Em qualquer trimestre, quatro versões estão disponíveis. Essas quatro versões são compatíveis.

Verificações de versão

Para 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 do navegador, 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 do desenvolvedor sempre descreve a versão semanal.

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