Começar

Selecione a plataforma: Android iOS JavaScript

Siga estas etapas para configurar o estilo baseado em dados para limites.

Ativar o novo renderizador de mapas

Um renderizador de mapa atualizado está disponível a partir da versão 18.0.0 do SDK do Maps para Android. Ele traz muitas melhorias, incluindo o suporte à Estilização de mapas baseada na nuvem.

Com o lançamento da versão 18.2.0 do SDK do Maps para Android, o Google mudou do renderizador de mapas padrão legado para o atualizado. Assim, o renderizador atualizado agora é usado por padrão para criar ou recriar um app.

Atenção: para usar o estilo orientado a dados para limites no seu app, ele precisa ser criado com o renderizador de mapas atualizado. Se você estiver adicionando estilo baseado em dados para limites a um app atual, recrie-o para usar o renderizador atualizado. Confira mais informações em Novo renderizador de mapas.

Criar um ID de mapa

Para criar um novo ID de mapa, siga as etapas em Criar um ID de mapa. Defina o tipo de mapa como Android.

Criar um estilo de mapa

Para criar um estilo de mapa, siga as instruções em Gerenciar estilos de mapa. Crie um estilo e associe ao ID do mapa que acabou de criar.

Selecione as camadas de elementos no novo estilo de mapa

No Console de APIs do Google, selecione as camadas de elementos a serem mostradas no novo estilo de mapa. A camada de elementos determina os tipos de limite que aparecem no mapa (por exemplo, localidades, estados etc.).

Importante: para garantir a performance ideal, selecione apenas as camadas necessárias.

1. No Console de APIs do Google, acesse a página Estilos de mapa.
2. Selecione um projeto, se solicitado.
3. Selecione um estilo de mapa.
4. Clique no menu suspenso Camadas de elementos para adicionar ou remover camadas.
5. Clique em Salvar para disponibilizar as mudanças nos mapas.

Atualizar o código de inicialização do seu mapa

Nesta etapa, você vai precisar do ID de mapa que acabou de criar. Ele pode ser encontrado na página Gerenciamento de mapas.

Para adicionar o ID do mapa ao código de inicialização, consulte Adicionar o ID do mapa ao seu app.

Ter acesso a uma camada de elementos de um mapa

Use um objeto FeatureLayer para representar cada camada de elemento de um mapa, como código postal ou camada de elemento de localidade. Para acessar um objeto de camada de elementos, chame GoogleMap.getFeatureLayer() na inicialização do mapa:

Java

private FeatureLayer postalCodeLayer;

@Override
public void onMapReady(GoogleMap map) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build());
  ...
}

Kotlin

private var postalCodeLayer: FeatureLayer? = null

override fun onMapReady(googleMap: GoogleMap) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = googleMap.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build())
  ...
}

Transmita um objeto FeatureLayerOptions para getFeatureLayer() para especificar o tipo da camada de elementos. Neste exemplo, você quer acessar a camada POSTAL_CODE. Crie um objeto FeatureLayer diferente para cada camada que você quer estilizar.

Depois de ter o objeto FeatureLayer, é possível aplicar estilos aos polígonos de limite no elemento.

Observação :se não houver um FeatureLayer do tipo especificado para o mapa ou se o estilo baseado em dados para limites não estiver ativado porque você não especificou o ID do mapa, essa chamada vai retornar, mas registrar um erro. Use o método FeatureLayer.isAvailable() para determinar se um FeatureLayer está disponível.

Verificar os recursos do mapa (obrigatório)

O estilo baseado em dados para limites exige um ID do mapa. Se essa informação não for adicionada ou for inválida, o estilo baseado em dados para limites não será carregado. Como uma etapa de solução de problemas, use MapCapabilities para verificar se o estilo orientado a dados para limites é aceito.

Atenção: alguns dispositivos podem não ser compatíveis com o novo renderizador de mapas e, portanto, não mostram o estilo baseado em dados para limites. Use MapCapabilities para verificar a compatibilidade no tempo de execução. Se o estilo orientado a dados para limites não tiver suporte, defina uma opção alternativa. Confira os requisitos de dispositivos para o novo renderizador de mapas em Dispositivos compatíveis.

Kotlin

val capabilities: MapCapabilities = googleMap.getMapCapabilities()
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable())

Java

MapCapabilities capabilities = googleMap.getMapCapabilities();
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable());