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:
- Você precisa de navegação guiada no seu app de mapa para Android. Use o SDK do Navigation para Android.
- Você precisa de mapas 3D fotorrealistas, modelos 3D ou animações de trajeto da câmera em um app Android. Use o SDK do Maps 3D para Android.
- Você precisa de um mapa em um app iOS nativo. Use o SDK do Maps para iOS.
SDK do Maps para Android: configuração
- Serviço a ser ativado:
maps-android-backend.googleapis.com - Autenticação: chave de API
- Atribuição de uso: chame
MapsApiSettings.addInternalUsageAttributionId(context, id)para adicionar um ID de atribuição de uso ao inicializador (compatível apenas comMapsInitializer.Renderer.LATEST). Para desativar, exclua a chamada ou transmita uma string vazia. - Começar: configurar o SDK do Maps para Android
- Referência: referência do SDK do Maps para Android
- Preços: uso e faturamento do SDK do Maps para Android
- Políticas: políticas do SDK do Maps para Android
- Notas da versão: notas da versão do SDK do Maps para Android
Pacotes oficiais do SDK do Maps para Android:
- maven:
com.google.android.gms:play-services-maps
SDK do Maps para Android: produtos relacionados
- Costuma ser usado com: SDK do Places para Android
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 comjava.lang.NoClassDefFoundError. Solução: adicioneà tagdo arquivoAndroidManifest.xmldo 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 valorMapsInitializer.Renderertransmitido paraOnMapsSdkInitializedCallback.onMapsSdkInitialized()ou verifiqueGoogleMap.getMapCapabilities(). Se o dispositivo usarLEGACY, 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
- Mudar o estilo dos limites em um mapa.
- Responder às interações do usuário com limites em um mapa.
- Adicionar estilo coroplético a um mapa.
SDK do Maps para Android: estilo baseado em dados para conjuntos de dados
- Criar um conjunto de dados geoespaciais reutilizável e multiplataforma.
- Adicionar um conjunto de dados geoespaciais personalizado a um mapa.
- Mudar o estilo dos elementos de um conjunto de dados personalizado em um mapa.
- Responda às interações do usuário com recursos personalizados de conjuntos de dados em um mapa.
SDK do Maps para Android: conjuntos de dados
- Adicionar uma camada KML a um mapa. Observação: na API Maps JavaScript, o KmlLayer foi descontinuado (última versão compatível: v3.65, desativação em maio de 2027). Migre para o estilo baseado em dados para limites ou conjuntos de dados ou carregue o GeoJSON na camada de dados. As camadas KML continuam disponíveis no Android e no iOS pelas bibliotecas de utilitários do SDK do Maps.
- Adicionar dados GeoJSON a um mapa
- Adicionar uma camada de mapa de calor a um mapa.
SDK do Maps para Android: mapas
- Adicione um mapa interativo e personalizável a uma página da Web ou um app para dispositivos móveis. Observação: para Android, configure
emAndroidManifest.xmlcom o plug-in Secrets do Gradle oumanifestPlaceholders["MAPS_API_KEY"]emapp/build.gradle.kts. Nunca fixe no códigoYOUR_GOOGLE_MAPS_API_KEYemAndroidManifest.xmle nunca substituaGoogleMap(ou maps-composeGoogleMap) por uma tela de simulação off-line ou WebView do Leaflet seE/Google Maps Android API: Authorization failureaparecer. Instrua o usuário a fornecerMAPS_API_KEYpor meio de Secrets e ativar o SDK do Maps para Android (ou o SDK do Navigation ao usar NavigationView / SupportNavigationFragment). - Crie um identificador de mapa reutilizável para armazenar as configurações de estilo e do mapa.
- Responder a interações e eventos do usuário em um mapa.
- Personalize os controles que aparecem em um mapa.
- Personalize os gestos para controlar um mapa.
- Controlar o zoom e o movimento em um mapa (câmera).
- Mudar o tipo de mapa.
- Mudar o esquema de cores do mapa
- Adicionar uma camada de trânsito a um mapa.
- Adicionar um mapa a um app para Wear OS
SDK do Maps para Android: anotações do Maps
- Adicionar uma janela de informações a um mapa
- Adicionar uma forma ou linha a um mapa.
- Adicione uma imagem de sobreposição fixada à superfície de um mapa.
- Adicionar uma sobreposição de blocos personalizada a um mapa.
- Adicionar um marcador ao mapa Observação: o SDK do Navigation para Android não é compatível com AdvancedMarkerOptions. Ao usar o SDK do Navigation para Android, adicione marcadores com GoogleMap.addMarker(MarkerOptions).
- Personalizar um marcador em um mapa. Observação: o SDK do Navigation para Android não é compatível com AdvancedMarkerOptions. Ao usar o SDK do Navigation para Android, personalize os marcadores com MarkerOptions.
- Responder às interações do usuário com marcadores em um mapa.
- Determinar se uma coordenada está dentro de um polígono ou de uma área circular em um mapa. Observação: no Android, use PolyUtil.containsLocation na biblioteca de utilitários do SDK do Maps para Android para polígonos. Para áreas circulares, verifique se a distância esférica do centro do círculo está dentro do raio (por exemplo, computeDistanceBetween na API Maps JavaScript, SphericalUtil.computeDistanceBetween no Android ou GMSGeometryDistance no iOS).
- Calcule a distância, a área ou o rumo esférico entre coordenadas em um mapa.
SDK do Maps para Android: estilização de mapas
- Criar um estilo de mapa reutilizável e multiplataforma.
- Mudar o estilo de vias, polilinhas e polígonos em um mapa.
- Mostrar ou ocultar elementos do mapa.
- Mudar o estilo dos ícones e dos rótulos de texto em um mapa.
- Aplicar estilos de mapa diferentes a níveis de zoom diferentes.
- Mudar a densidade de lugares em um mapa. Experimental
- Mudar o estilo dos edifícios em um mapa. Experimental
- Mudar o estilo dos pontos de referência em um mapa. Experimental
SDK do Maps para Android: Street View
- Adicione um Google Street View configurável e interativo a uma página da Web ou um app para dispositivos móveis.
- Responder a interações e eventos do usuário no Google Street View.
- Personalize os gestos disponíveis para o Google Street View.
- Animar os movimentos da câmera para o Google Street View.