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 quais tipos de limites 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

Você usa um objeto FeatureLayer para representar cada camada de elementos de um mapa, como uma camada de elementos de código postal ou 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 elemento. 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 um FeatureLayer do tipo especificado não existir para o mapa ou se o estilo orientado a dados para limites não estiver ativado porque você não especificou o ID do mapa, essa chamada será retornada, mas vai gerar 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 o ID do mapa estiver ausente ou for inválido, o estilo baseado em dados para limites não poderá ser carregado. Como 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 baseado em dados para limites não tiver suporte, defina uma opção alternativa. Para saber os requisitos de dispositivo para o novo renderizador de mapas, consulte 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());