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 da API 15 ou mais recentes para Android. Ao definir o build do seu projeto, use 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 {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation 'com.google.maps.android:android-maps-utils:3.8.0'
}

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 em Kotlin de forma concisa e idiomática. 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 {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.1.1'
}

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, bifurque o repositório.

O repositório inclui:

• Um app de demonstração no diretório demo
• A biblioteca de utilitários no diretório library
• Diversos arquivos contendo informações sobre licença, colaboradores e o arquivo readme.
• 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. Adicione uma única linha a local.properties parecida com esta:

   MAPS_API_KEY=YOUR_API_KEY

   Neste caso, YOUR_API_KEY é a chave de API que você recebeu, conforme descrito no artigo Usar chaves de API.

6. 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.