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 baseado em dados para limites no seu app, ele precisa ser usando o renderizador de mapa atualizado. Se você está adicionando estilo baseado em dados para limites de um app atual, recrie para que ele use o renderizador de mapa 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, você pode selecionar quais camadas de elementos exibir para seu novo estilo de mapa. A camada de elementos determina os 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 no seu Gerenciamento de mapas.

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

Acessar uma camada de elementos de um mapa

Você usa um FeatureLayer para representar cada camada de elemento de um mapa, como CEP ou Camada de elemento de localidade. Para ter acesso a um objeto da camada de elementos, chame GoogleMap.getFeatureLayer() quando o mapa for inicializado:

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 FeatureLayerOptions. como getFeatureLayer() para especificar o tipo de camada de elementos. Neste exemplo, se você quiser acessar a camada POSTAL_CODE. Crie uma Objeto FeatureLayer para cada camada que você quer estilizar.

Depois de criar o objeto FeatureLayer, você pode aplicar o estilo ao polígonos de limites nesse elemento.

Observação: se um FeatureLayer do tipo especificado não existir para o mapa ou se o estilo baseado em dados para limites não estiver ativado porque você não especificado o ID do mapa, essa chamada retorna, mas registra um erro. Use o 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 um um ID de mapa inválido é transmitido, o estilo baseado em dados para limites não pode ser carregado. Como etapa de solução de problemas, use MapCapabilities para verificar se o estilo baseado em dados para limites é compatível.

Atenção :alguns dispositivos podem não ser compatíveis com o novo renderizador de mapas. não pode mostrar 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 tem suporte. Defina uma opção alternativa. Para conhecer os requisitos de dispositivos para o novo renderizador de mapas, consulte Compatível dispositivos.

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());