Filtragem de dados nos Mapas do Fabric

A filtragem de dados nos Mapas do Fabric permite limitar quais registros são renderizados em uma camada de mapa com base em valores de atributo. A filtragem se aplica por camada, não no nível do mapa e afeta apenas como os dados são visualizados, não a fonte de dados subjacente.

A filtragem está disponível para camadas de dados vetoriais criadas a partir de fontes de dados compatíveis, incluindo GeoJSON, PMTiles, Kusto, Ontology (versão preliminar) e serviços de feições externos.

Camadas externas de serviço de recursos também podem ter uma consulta de código-fonte que limita quais registros e campos o serviço remoto retorna. Uma consulta de origem é avaliada pelo serviço remoto antes que o Fabric Maps recupere os dados. Os filtros de camada de mapa descritos neste artigo se aplicam apenas às características recuperadas. Para mais informações, veja Consultas de origem e filtros de camada de mapa.

Camadas externas de serviço de feição suportam o mesmo comportamento de filtragem nos modos de construtor e visualizador que o de outras camadas vetoriais, incluindo filtros bloqueados e persistência de filtros. Valores de data/hora são interpretados como UTC no formato RFC 3339.

Como funciona a filtragem de dados

Cada camada de mapa avalia suas próprias condições de filtro de forma independente. Quando os filtros são aplicados, somente os registros que correspondem a todas as condições são renderizados para essa camada.

Principais características:

• Os filtros têm escopo de camada
• Os filtros não afetam outras camadas do mapa
• Vários filtros na mesma camada são combinados usando a lógica AND
• A filtragem altera o subconjunto visualizado de dados, não os dados de origem

Tipos de filtro com suporte

Os tipos de filtro disponíveis dependem da fonte de dados e do tipo de campo.

Comportamento do construtor e do consumidor

O comportamento de filtragem difere dependendo se um mapa é aberto no modo de edição ou modo de exibição.

Construtores de mapas (modo de edição)

Os construtores de mapas podem:

• Adicionar, modificar e remover filtros em uma camada
• Salvar filtros com o mapa
• Bloquear filtros específicos para impedir a remoção no modo de exibição

Os filtros bloqueados definem um escopo de dados de linha de base que se aplica sempre que o mapa é aberto.

Mapear consumidores (modo de exibição)

Os consumidores de mapa podem:

• Adicionar, remover ou modificar filtros desbloqueados durante o runtime
• Interagir com dados filtrados sem alterar o mapa salvo

As alterações de filtro do consumidor são temporárias e não são salvas.

Filtros bloqueados:

• São aplicados automaticamente
• Não é possível ser removido no modo de exibição

Persistência de filtro

• Os filtros configurados e salvos por um construtor de mapas persistem com o mapa.
• As alterações feitas pelo usuário são redefinidas quando o mapa é reaberto.
• Os filtros bloqueados persistem até serem removidos explicitamente por um construtor no modo de edição.

Interação com outros recursos de camada

A filtragem se integra a outras funcionalidades de nível de camada:

• O zoom para ajustar ajusta o modo de exibição de mapa ao conjunto de dados filtrado.
• Estilo baseado em dados e rótulos de dados operam nos resultados filtrados.
• As camadas de marcador personalizado respeitam os filtros ativos.

Limitações e considerações de design

Os filtros de dados apresentam as seguintes limitações e considerações de projeto:

• Se uma fonte GeoJSON ou PMTiles não tiver propriedades, o filtro não pode acessar nenhum campo.
• Os controles de intervalo numérico abreviam valores grandes (por exemplo, 4,2B) para melhorar a legibilidade. Passe o mouse sobre o número para ver o valor exato.
• A filtragem funciona apenas em camadas vetoriais. Você não pode filtrar camadas de imagens.

Próximas Etapas