Mapas personalizados

Mapas personalizados

Por padrão, o Analytics utiliza o OpenStreetMaps para visualizações de mapas, mas existem algumas opções de personalização.

Configurações do mapa

Para encontrar as configurações do mapa:

1. No canto superior direito da tela, clique no ícone de engrenagem > Configurações do administrador > Configurações.
2. Selecione Maps na navegação à esquerda.

Servidor de tiles do mapa

Por padrão, o Analytics usa o servidor de tiles do OpenStreetMaps para mapas de pontos e de grade. Se sua organização precisar de uma aparência diferente ou um nível de detalhe distinto nas visualizações de mapa, você pode alterar o servidor de tiles do mapa adicionando o caminho do servidor no primeiro campo da página.

O caminho deve ser uma URL que comece com http:// ou https:// ou um caminho relativo para um arquivo local no classpath da JVM.

Atualmente, o Analytics utiliza um único servidor de tiles por instância. Não é possível especificar tiles diferentes para mapas distintos.

Mapas de regiões personalizados

O Analytics oferece dois mapas de regiões embutidos: mapa mundial com países e mapa dos Estados Unidos com estados.

Se você precisar de mapas de outras regiões — como países da UE ou bairros de Nova York — pode especificar um arquivo GeoJSON contendo as informações das regiões. É comum encontrar mapas GeoJSON pesquisando online por “[Sua região] + geojson”, por exemplo “NYC neighborhoods GeoJSON”. Muitas comunidades e órgãos governamentais já desenvolveram arquivos de mapas para regiões comuns. Você também pode criar seu próprio GeoJSON com ferramentas como MapShaper ou GeoJSON.io.

Seu arquivo GeoJSON deve:

• Ter menos de 5 MB de tamanho.
• Conter feições do tipo polígono definindo as regiões (não apenas pontos ou coordenadas).
• Usar coordenadas geográficas (latitude e longitude) para definir os polígonos das regiões. O Analytics não suporta coordenadas projetadas, sendo necessário converter coordenadas projetadas para coordenadas geográficas.
• Estar acessível por uma URL pública. Atualmente, não é possível fazer upload de GeoJSON no Analytics.

Para adicionar um mapa personalizado:

1. Acesse Configurações do administrador > Maps > Custom Maps.
2. Clique em Add a Map.
3. Digite um nome para o seu mapa.
4. Informe a URL do seu arquivo GeoJSON.
5. Especifique as propriedades JSON que devem servir como identificador da região e nome da região.

• Nome do mapa será exibido no seletor de regiões para mapas de regiões personalizados.
• Identificador da região é um campo no GeoJSON que identifica sua região. Os valores deste campo devem corresponder à forma como as regiões são referenciadas nos seus dados. O campo não precisa ser o nome exibido.
• Nome exibido da região é um campo no GeoJSON que especifica como o nome da região será exibido no mapa. Pode ser diferente do identificador da região.

Para pré-carregar um ou mais mapas de regiões ao iniciar o Analytics, você pode usar a variável de ambiente MB_CUSTOM_GEOJSON ou a opção de arquivo de configuração custom-geojson.

Para desabilitar a criação de mapas personalizados, utilize a variável de ambiente MB_CUSTOM_GEOJSON_ENABLED ou a opção de arquivo de configuração custom-geojson-enabled.