Pronto!

Para começar a desenvolver, acesse nossa documentação do desenvolvedor.

Ative a Google Maps Android API

Para começar, orientaremos você pelo Google Developers Console para realizar algumas atividades:

  1. Criar ou selecionar um projeto
  2. Ative a Google Maps Android API
  3. Criar chaves apropriadas
Continuar

Biblioteca de utilitários da Google Maps Android API

Procurando recursos avançados para usar em seus mapas? A Biblioteca de utilitários da Google Maps Android API é uma biblioteca de código aberto, útil para diversos aplicativos. O repositório GitHub inclui as classes de utilitários e um aplicativo de demonstração que mostra o uso de cada classe.

Neste vídeo, Chris Broadfoot discute a biblioteca de utilitários, com ênfase em decodificação de polilinhas, geometria esférica e ícones de bolha.

Configuração rápida

Adicione a seguinte dependência ao arquivo de compilação do Gradle do seu aplicativo:

dependencies {
    compile 'com.google.maps.android:android-maps-utils:0.4+'
}

Para obter mais detalhes, siga o guia de configuração.

Os utilitários

Um mapa com uma camada GeoJSON

Importar GeoJSON para o seu mapa

Você pode armazenar recursos no formato GeoJSON e usar esse utilitário para renderizá-los como uma camada sobre um mapa. Chame addLayer() para adicionar dados GeoJSON ao mapa. Também é possível adicionar recursos individuais chamando addFeature() e passando um objeto GeoJsonFeature.

Para obter detalhes, consulte a documentação do utilitário GeoJSON do Google Maps Android.

Um mapa com uma camada KML

Importar KML para o seu mapa

O uso desse utilitário permite converter objetos KML em formas geográficas e renderizá-las como uma camada sobre um mapa. Chame addLayerToMap() para adicionar a camada ao mapa. Você pode acessar as propriedades de um objeto KML chamando getProperties() em qualquer Placemark, GroundOverlay, Document ou Folder.

Para obter detalhes, consulte a documentação do utilitário KML do Google Maps Android.

Um mapa com um mapa de calor

Adicionar mapas de calor ao seu mapa

Os mapas de calor permitem que os visualizadores compreendam com mais facilidade a distribuição e a intensidade relativa de pontos de dados em um mapa. Em vez de colocar um marcador em cada localização, os mapas de calor usam cores e formas para representar a distribuição dos dados. Crie um HeatmapTileProvider passando uma coleção de objetos LatLng que representam os pontos de interesse no mapa. Em seguida, crie um novo TileOverlay passando o provedor de blocos do mapa de calor e adicione a sobreposição de blocos ao mapa.

Para obter detalhes, consulte a documentação do utilitário de mapa de calor do Google Maps Android.

Um mapa com ícones de bolha

Personalizar marcadores com ícones de bolha

Adicione um IconGenerator para exibir fragmentos de informações nos marcadores. Com esse utilitário, os ícones de marcadores podem ter uma aparência semelhante a janelas de informações, permitindo que o próprio marcador tenha texto e outro conteúdo. A vantagem é a possibilidade de manter mais de um marcador aberto ao mesmo tempo, enquanto que apenas uma janela de informações pode ser aberta de cada vez. Também é possível aplicar estilo aos marcadores, alterar a orientação do marcador e/ou conteúdo e alterar a imagem/nine-patch de segundo plano dos marcadores.

Um mapa com marcadores em cluster

Gerenciar clusters de marcadores

O ClusterManager ajuda a gerenciar vários marcadores em diferentes níveis de zoom. Isso significa que é possível colocar mais marcadores em um mapa sem dificultar a leitura. Quando um usuário visualiza um mapa em um nível de zoom alto, os marcadores individuais são exibidos no mapa. Quando o usuário diminui o zoom, os marcadores se reúnem em clusters, facilitando a visualização do mapa.

Para obter detalhes, consulte a documentação do utilitário de clustering do Google Maps Android.

Um mapa com uma polilinha codificada

Codificar e decodificar polilinhas

O utilitário PolyUtil é útil para converter polilinhas e polígonos codificados em coordenadas de latitude/longitude e vice-versa.

No Google Maps, as coordenadas de latitude e longitude que definem uma polilinha ou um polígono são armazenadas como uma string codificada. Consulte as explicações detalhadas da codificação de polilinhas. Essa string codificada é recebida como resposta de uma API do Google, como Google Maps Directions API.

O PolyUtil na biblioteca de utilitários da Google Maps Android API pode ser usado para codificar uma sequência de coordenadas de latitude/longitude ('LatLngs') gerando uma string de caminho codificada e para decodificar uma string de caminho codificada gerando uma sequência de LatLngs. Isso garante a interoperabilidade com os serviços Web das Google Maps APIs.

Distância calculada entre dois pontos em um mapa

Calcular distâncias, áreas e rumos usando geometria esférica

Usando os utilitários de geometria esférica no SphericalUtil, é possível calcular distâncias, áreas e rumos com base em latitudes e longitudes. Veja a seguir alguns dos métodos disponíveis:

  • computeDistanceBetween() – retorna a distância, em metros, entre duas coordenadas de latitude/longitude.
  • computeHeading() – retorna o rumo, em graus, entre duas coordenadas de latitude/longitude.
  • computeArea() – retorna a área, em metros quadrados, de um caminho fechado no planeta.
  • interpolate() – retorna as coordenadas de latitude/longitude de um ponto posicionado a uma determinada fração da distância entre dois pontos especificados. Esse método pode ser usado, por exemplo, para animar um marcador entre dois pontos.

Consulte a documentação de referência para obter uma lista completa dos métodos do utilitário.

Enviar comentários sobre…

Google Maps Android API
Google Maps Android API
Precisa de ajuda? Acesse nossa página de suporte.