Referência rápida do SDK do Maps para Android

O SDK do Maps para Android adiciona dados do Google Maps, exibições de mapa e respostas de gestos no mapa a apps Android, incluindo apps para Wear OS. Você pode adicionar marcadores, polígonos e sobreposições para mostrar informações sobre locais no mapa e permitir a interação do usuário, usando Kotlin ou Java.

SDK do Maps para Android: informações importantes

  • Produto: SDK do Maps para Android
  • Também conhecida como: API Google Maps para Android
  • Categoria: Maps
  • Plataforma: Android
  • Executado em: cliente (código do app ou do navegador)
  • Estágio de lançamento: GA
  • Ciclo de vida: Ativo
  • Visão geral: Visão geral do SDK do Maps para Android
  • Disponibilidade regional: global. Consulte a página de cobertura da Plataforma Google Maps. Os links da página de uso e faturamento separam as listas de preços globais e da Índia. (detalhes da cobertura)

SDK do Maps para Android: quando usar

Use o SDK do Maps para Android quando:

  • Você precisa de um mapa interativo em 2D do Google em um app nativo para Android ou Wear OS.
  • Você precisa adicionar marcadores, janelas de informações, polilinhas, polígonos, sobreposições de solo ou de blocos a um mapa em um app Android.
  • Você precisa de panoramas do Street View, mapas no Modo Lite (bitmap) ou Estilização de mapas baseada na nuvem com IDs de mapa em um app Android.
  • Você cria um mapa do Android em Kotlin ou Java, incluindo o Jetpack Compose, usando a biblioteca do Maps Compose.

Não use o SDK do Maps para Android quando:

SDK do Maps para Android: configuração

Pacotes oficiais do SDK do Maps para Android:

  • maven: com.google.android.gms:play-services-maps

SDK do Maps para Android: erros comuns

  • Problema: desde a versão 20.0.0, o manifesto do SDK não inclui mais a biblioteca org.apache.http.legacy. Os apps que carregam o renderizador de mapas legado podem falhar com java.lang.NoClassDefFoundError. Solução: adicione à tag do arquivo AndroidManifest.xml do app. Os dispositivos com o Google Play Services 25.50.34 ou mais recente não são afetados. Consulte /maps/documentation/android-sdk/release-notes.
  • Problema: os Marcadores Avançados precisam do renderizador de mapas atualizado. Se você os adicionar a um app atual sem recriá-lo, o app ainda poderá usar o renderizador legado. Correção: recrie o app com o SDK 18.2.0 ou mais recente para que o renderizador atualizado seja o padrão. Consulte /maps/documentation/android-sdk/advanced-markers/start.
  • Problema: os dispositivos que não atendem aos requisitos do renderizador (Android 5.0/API 21 ou mais recente, Google Play Services 21.39.14 ou mais recente, Play Store ativada) usam o renderizador legado. Por isso, os recursos que precisam do novo renderizador, como a estilização de mapas baseada na nuvem, não estão disponíveis neles. Correção: chame MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) e verifique o valor MapsInitializer.Renderer transmitido para OnMapsSdkInitializedCallback.onMapsSdkInitialized() ou verifique GoogleMap.getMapCapabilities(). Se o dispositivo usar LEGACY, não use a Estilização de mapas baseada na nuvem nem os Marcadores Avançados. Consulte /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback.
  • Problema: o SDK requer o Google Play Services no dispositivo em que o app é executado. Correção: se quiser, chame a verificação de disponibilidade do Google Play Services no seu app. Consulte /maps/documentation/android-sdk/config.

SDK do Maps para Android: recursos legados e descontinuados

  • Renderizador de mapa legado: descontinuado desde 04/03/2024. Substituição: renderizador de mapa atualizado (mais recente), que é o padrão desde o SDK 18.2.0. Sintoma: a estilização de mapas baseada na nuvem, as personalizações de polilinhas avançadas e os Marcadores Avançados não estão disponíveis no renderizador legado. Consulte o guia de migração.

O que você pode fazer com o SDK do Maps para Android

Consulte os guias abaixo para cada tarefa ou compare os produtos no Explorador de recursos.

SDK do Maps para Android: estilo baseado em dados para limites

SDK do Maps para Android: estilo baseado em dados para conjuntos de dados

SDK do Maps para Android: conjuntos de dados

SDK do Maps para Android: mapas

SDK do Maps para Android: anotações do Maps

SDK do Maps para Android: estilização de mapas

SDK do Maps para Android: Street View