Configuração dos utilitários do SDK do Maps para Android

Esta página descreve como configurar a biblioteca de utilitários do SDK do Maps para Android e executar o app de demonstração incluído na biblioteca.

Pré-requisitos e observações

A biblioteca de utilitários do SDK do Maps para Android é compatível com os níveis de API 15 ou mais recentes para Android. Ao definir o alvo de compilação do projeto, não deixe de usar o nível mais recente da API para Android.

A documentação de referência (em inglês) está disponível no GitHub.

Etapa 1. Instalar a biblioteca de utilitários do SDK do Maps para Android

Adicione a seguinte dependência ao arquivo build.gradle do seu app:

dependencies {
    implementation 'com.google.maps.android:android-maps-utils:2.2.3'
}

Use um dos utilitários da biblioteca, como clustering de marcadores, mapas de calor ou outras utilidades.

Etapa 2. Instalar a biblioteca KTX de utilitários do SDK do Maps para Android (opcional)

A biblioteca de utilitários do SDK do Maps para Android vem com uma biblioteca correspondente das extensões Kotlin (KTX). Ela fornece recursos da linguagem Kotlin, como funções de extensão, argumentos nomeados e argumentos padrão, para permitir que você escreva um Kotlin conciso e idiomático. Se você não estiver desenvolvendo em Kotlin, pule esta etapa.

Para usar essa biblioteca, adicione a seguinte dependência, além da android-maps-utils, ao arquivo build.gradle do app:

dependencies {
    implementation 'com.google.maps.android:maps-utils-ktx:3.2.0'
}

Consulte a página Maps KTX do GitHub (em inglês) para ver mais informações sobre essa biblioteca.

Etapa 3. Ver o código-fonte da biblioteca de utilitários do SDK do Maps para Android

Como a biblioteca de utilitários tem código aberto, você pode fazer o download de android-maps-utils na sua máquina para personalizá-la, ver o app de demonstração ou apenas entender o funcionamento dela. Para fazer isso, clone o repositório (recomendado, para receber atualizações automáticas) ou faça o download de um arquivo ZIP. Se você quiser personalizar a biblioteca, faça um fork do repositório.

O repositório inclui:

  • Um app de demonstração no diretório demo
  • A biblioteca de utilitários no diretório library
  • A biblioteca de utilitários para o SDK do Maps para a v3 Beta, no diretório library-v3
  • Diversos arquivos contendo informações sobre licença, colaboradores e "leia-me"
  • Configuração do build do Gradle para uso com o Android Studio

Executar o app de demonstração do utilitário

O repositório do GitHub para a biblioteca de utilitários é fornecido com um app de demonstração que inclui as implementações de amostra de cada utilitário. Siga estas etapas para executá-lo no seu dispositivo Android.

  1. Faça o download do repositório usando uma das opções mencionadas acima.
  2. No Android Studio, escolha File > New > Import Project.
  3. Navegue até o diretório android-maps-utils, criado ao clonar a biblioteca de utilitários e selecione-o clicando duas vezes. O Android Studio iniciará a compilação do projeto.
  4. Se você estiver usando um dispositivo Android em vez de um emulador, ative o modo de desenvolvedor. Depois, conecte o dispositivo Android ao computador.
  5. Crie e execute o app de demonstração.

O aplicativo abrirá no dispositivo Android, exibindo uma lista de utilitários, incluindo agrupamento, polyutil e mapa de calor, entre outros. Você também encontra o app na lista de aplicativos com o nome Maps Utils Demo.