SDK do Maps para Android

Com o SDK do Maps para Android, você pode adicionar mapas ao seu app Android, incluindo aplicativos Wear OS usando dados, exibições de mapa e respostas de gestos no mapa do Google Maps. Também é possível fornecer outras informações sobre locais e permitir a interação do usuário adicionando marcadores, polígonos e sobreposições ao seu mapa.

O SDK aceita as linguagens de programação Kotlin e Java e disponibiliza outras bibliotecas e extensões para técnicas de programação e recursos avançados.

Versões

A equipe da Plataforma Google Maps atualiza regularmente os SDKs com novos recursos, correções de bugs e melhorias na performance. Nesta página, mostramos como gerenciar suas dependências em SDKs para dispositivos móveis.

A qual versão vincular?

  • No caso de apps essenciais, faça o vínculo à atualização mais recente da versão principal que você está usando (X.*). Nesse método, é preciso atualizar o app pelo menos uma vez por ano, quando uma nova versão principal é lançada.
  • No caso de apps não essenciais, vincule a qualquer versão fixa. Após receber um aviso de descontinuação da versão fixa, você vai ter 12 meses para disponibilizar o código atualizado do app aos usuários. Esse método exige manutenção com menor frequência, mas pode envolver uma quantidade maior de recursos para adaptar, reescrever e testar conteúdo do que atualizações anuais. Esse trabalho precisaria ser concluído antes da descontinuação.

Os proprietários de projetos com endereços de e-mail monitorados recebem notificações proativas sobre mudanças que afetam os projetos deles. Fique sabendo de atualizações importantes, descontinuações e outras mudanças.

Instalação

No arquivo build.gradle no nível do app, sempre especifique uma versão em vez de um intervalo de prefixos (+) ou latest, já que isso pode gerar builds imprevisíveis e únicas. O SDK do Maps para Android segue o controle de versões semânticas, e novas versões principais podem incluir alterações interruptivas. O nível mínimo compatível da API é 19.

Especifique a dependência do Maps no Google Play Services usando a sintaxe do Gradle

dependencies {
    implementation 'com.google.android.gms:play-services-maps:18.1.0'
    // ...
}

Manutenção e upgrade

O Android Studio verifica automaticamente se há versões mais recentes das dependências e avisa quando há uma nova disponível. Para minimizar o impacto técnico, atualize para a versão mais recente disponível o quanto antes. Se você estiver atualizando para uma nova versão principal, leia as notas e confira se há mudanças incompatíveis com versões anteriores e como atualizar seu código.

Os proprietários de projetos recebem notificações sobre as versões mais recentes e e-mails do Google Cloud informando sobre mudanças incompatíveis com versões anteriores que podem afetar os projetos. Para receber essas notificações, atribua a função de proprietário com um endereço de e-mail monitorado em cada um dos seus projetos.