Roteiro para inclusão de camadas no i3Geo 

 
Planejamento 

● Observações:

A inclusão de uma camada no i3Geo deve ser planejada de forma cuidadosa, visando
facilitar a manutenção do sistema, evitar duplicidades, facilitar o acesso e o uso dos
dados.

Ao adicionar uma nova camada deve-se levar em conta o catálogo como um todo,
considerando-se os dados já existentes e os que ainda serão inseridos.

● Defina qual será o título da nova camada, ou seja, o nome que será visto pelo usuário
do mapa interativo.

● Escolha um nome de arquivo que não seja muito longo mas que remeta ao título da
camada.

● Se a camada fizer parte de uma série de dados, considere o uso de um prefixo para a
série.

● No caso de séries temporais, inclua no título e no nome do arquivo a data ou ano.

● Evite a proliferação de camadas em função de recortes geográficos. Os dados são em

sua maioria contínuos, e a região de interesse é definida em função da região visível no
mapa, não sendo necessário criar camadas para diferentes regiões.

● Verifique no banco de dados qual o tipo de geometria utilizada na camada (linha, ponto
ou polígono), isso pode ser feito utilizando-se o QGIS, bastando visualizar a camada.

● Verifique o nome correto da tabela no banco de dados que será a fonte para a camada.

● Explore a tabela e decida quais as colunas que deverão ficar disponíveis na camada.

● Caso seja necessário um SQL complexo para obter os dados, exigindo a realização de
filtros ou junção de tabelas, teste a criação desse SQL no pgAdmin.
 
Acesso ao sistema de administração 

● A criação de um mapfile é feita sempre por meio do sistema de administração (SA) do

i3Geo.

● O link de acesso é mostrado na página principal, para ir direto utilize

http://localhost/i3geo/admin

● Na página do SA, na parte localizada à direita da tela, existem botões de atalho na parte
superior. Dentre esses o botão “Mapfiles”, que leva à página do editor de mapfiles.

● Para utilizar as opções do editor é necessário “logar” no sistema. Utilize o login e a

senha fornecido pelo administrador do i3Geo.

 
Criação do mapfile 

● Na página do editor de mapfiles, acione o botão “Criar um novo mapfile”.

● Essa opção abrirá um formulário e depois criará um arquivo mapfile.

● Normalmente um arquivo mapfile contém um único LAYER. Cada LAYER recebe um

NAME que é o código que permitirá ao sistema de administração acionar e modificar
seus parâmetros.
 ● O NAME desse LAYER único será o mesmo que o nome definido para o arquivo mapfile
a ser definido no formulário de edição

● No formulário digite o código do LAYER e o título em português, deixando o restante

como está..

● Salve o arquivo.

● Navegue pela lista de mapfiles e verifique se o arquivo foi criado. Utilize as letras para
filtrar a lista.

 
Definição da conexão com os dados 

● A lista de mapfiles no editor é uma árvore hierárquica organizada em ordem alfabética.

● Ao expandir o primeiro nó (raiz) são mostrados os layers existentes. Ao expandir um

layer são mostradas as opções de edição dos parâmetros desse layer.
● Nesse exemplo utilizaremos o mapfile _lbairros. Para facilitar a operação pode ser
utilizado o filtro _lba para mostrar na listagem apenas esse mapfile.

● A definição dos parâmetros de conexão com o banco de dados, ou outro tipo de

armazenamento de dados, utiliza-se a opção “Conexão com os dados.

● Ao acionar essa opção é mostrado o formulário de opções.

● Procure por “Connectiontype” e escolha MS_POSTGIS

● Em seguida, escolha o tipo de geometria dos dados em “Type”

● Em “Connection” escolha o código da conexão que será utilizada para acesso ao banco
de dados (no caso do SIGEO basta digitar nesse campo a palavra “sigeo”.

● Com esses parâmetros já é possível definir o SQL que faz a consulta às tabelas do
banco para obter os dados que serão usados no layer.

● Ao lado do campo “Data” existe um ícone que abre um formulário que ajuda nessa
definição do SQL.

● Ao acionar esse ícone o formulário de construção do SQL é aberto. Na parte superior,

escolha a conexão novamente. Isso abrirá a lista de esquemas existentes no banco de
dados. Navegue pelos esquemas até encontrar a tabela desejada. Clique nessa tabela
para que o formulário possa listar as colunas disponíveis.
● A lista de colunas existentes na tabela escolhida é mostrada de forma a permitir a
escolha de três coisas: a coluna que contém os identificadores únicos de cada registro
(ID), a coluna que contém as geometrias (GEOM) e a lista de colunas que se quer usar
(MOSTRA).

● Busque na lista indicada em ID e GEOM e marque respectivamente as que contém os

identificadores únicos e as geometrias.

● Em NOME marque “Todas” caso todas as colunas serão mostradas ao usuário, ou

então marque apenas as colunas desejadas.

● Conforme essas escolhas são feitas, o SQL é mostrado na caixa de textos logo abaixo.
 ● Concluídas as escolhas, clique no botão “Aplicar”. O texto do SQL será então transposto
para o formulário de definição da conexão.

● Agora basta clicar na opção “Salva” do formulário para concluir.

 
Teste inicial 

● Após a definição da fonte dos dados já é possível testar o mapfile.

● Para isso clique no ícone “Testar!”

 ● Caso os dados forem mostrados no mapa, a conexão está funcionando corretamente.
Em alguns casos, quando os elementos são muito pequenos, pode ser difícil visualizar
os dados.

● Normalmente, quando ocorrem erros, é mostrada uma mensagem de “log” que pode
indicar qual o possível problema. Nesse caso, revise os parâmetros de conexão.

 
Disponibilidade de acesso 

● O i3Geo permite que os dados que forma um layer, definidos no mapfile, fiquem
disponíveis por meio de serviços.

● Dessa forma o usuário poderá fazer o download dos dados ou acessá-los por meio dos
padrões WMS, WFS ou KML.

● Por padrão, ao criar um mapfile esse acesso é permitido. Para bloquear esse tipo de
acesso é necessário alterar os parâmetros referentes à disponibilidade dos dados.

● Normalmente o bloqueio é feito para os mapfiles que estão relacionados a dados que
foram obtidos de terceiros, o que obriga os usuários a buscarem os dados diretamente
na fonte.

● As pricipais opções encontram-se no formulário acessível por meio do ícone “Editar

tema associado”

● No formulário, altere para não as opções como mostrado na figura abaixo

 ● Após salvar acesse a opção “Disponibilidade”

● No formulário aberto altere a opção que permite o download

Representação cartográfica 

Esse item trata dos parâmetros de configuração necessários para apresentar os dados,
principalmente as questões relativas à simbologia e classificação. Em um LAYER podem existir
uma ou mais classes, que na linguagem do Mapserver correspondem ao item CLASS … END.
Um aclasse pode ter um ou mais estilos, denominados como STYLE … END.

Quando um LAYER contém apenas uma classe, chamamos o tipo de classificação de “símbolo
único”, ou seja, um único símbolo é utilizado para representar todas as ocorrências. Quando as
ocorrências utilizam símbolos de acordo com um valor presente em uma coluna da tabela de
dados, chamamos de “valor único”. Essa tipologia não é rígida, pois cada classe pode ter sua
própria expressão de filtragem, ou seja, em cada classe podem ser feitas diferentes
combinações de colunas e cálculos.

● Quando um mapfile é criado, um LAYER é adicionado ao arquivo e uma classe é criada

nesse LAYER, permitindo sua visualização sem nenhum tratamento adicional.

● No editor de mapfiles, as classes e os estilos são mostrados como nós na árvore. Para
explorar esses elementos basta expandir os nós, como no exemplo abaixo (o exemplo
utiliza o mapfile “_lbiomashp” ou “_wbiomashp”)
● As classes podem ser criadas manualmente com a opção “Adicionar uma classe” ou
automaticamente utilizando-se a opção “Criar classes automaticamente”.

● Classes já existentes podem ser editadas utilizando-se a opção “Editar características

gerais” e “Editar toponímia”.

● Quando uma classe é criada, um estilo também é criado.

● Estilos são utilizados para possibilitar que símbolos complexos sejam construídos com
base em elementos mais simples, por exemplo:

● A maneira mais fácil de definir as classes é usando o próprio mapa interativo, para isso,
após criar o mapfile e definir a conexão com os dados clique no ícone que abre o i3Geo.

● No formulário, acione o ícone que abre o editor de legenda (nessa sequência foi criado
um mapfile com as localidades para usar como exemplo)
● Clique na imagem que representa o símbolo para abrir o editor de símbolos.

● No editor, escolha o símbolo e ajuste os parâmetros conforme desejar. Clique em

“Aplicar as alterações” para ver o resultado.
● Concluídos os ajustes, salve o mapfile e já pode fechar o i3Geo e voltar ao editor de
mapfiles.
● Para utilizar outros tipos de classificação, no editor de legenda clique na aba “Classes”.

● Ao fazer isso, o formulário irá mostrar novas opções, incluindo algumas técnicas de
classificação, como quartis e intervalos iguais.

● Para exemplificar, escolha a coluna chamada “tipo” e depois clique em “Valor único”.
● Após escolher o tipo de classificação, pode-se voltar à guia que mostra todas as classes
e alterar individualmente cada uma das que foram criadas.

● O nome da classe também pode ser modificado conforme for desejado.

 
Ajustes na ferramenta de identificação 

Existem duas ferramentas que ficam disponíveis nos mapa interativos e que permitem que o
usuário clique no mapa para ver os dados. Esses dados referem-se aos LAYERS cujos
elementos ocorram no ponto indicado.

● Os dados que são mostrados nessas ferramentas podem ser ajustados definindo-se
quais colunas da tabela de atributos serão mostradas e qual o apelido dessas colunas.

● A ferramenta de identificação completa, representada no mapa pelo ícone ,

mostra todas as colunas com seus respectivos apelidos. Já a ferramenta de etiquetas

ou “Tip”, representada pelo ícone , mostra apenas as colunas que forem

escolhidas para tal.

● Para fazer os ajustes, utilize a ferramenta “Etiquetas de identificação”

 ● No formulário que aberto, marque as colunas que serão utilizadas. Dessas colunas,
marque as que serão mostradas na ferramenta de etiquetas (Tip). Edite também os
apelidos caso seja desejado.

● Salve novamente o mapfile.

 
Ajustes adicionais 

● No editor de mapfiles, abra o formulário indicado (“Editar tema associado” e inclua o link
na internet com os metadados. Nesse formulário você pode também alterar o nome que
será utilizado no catálogo de camadas e criar a miniatura de imagem utilizada para
mostrar um preview ao usuário em algumas ferramentas.
● No formulário aberto com a opção “Título, escala, extensão” indique o denominador da
escala que é compatível com a fonte dos dados.
 
Inclusão do mapfile no catálogo 

O catálogo organiza as camadas que os usuários podem adicionar ao mapa. Essa organização
utiliza uma árvore hierárquica, composta de menus, grupos e subgrupos. O catálogo pode ter
mais de um menu e mapfiles podem ser repetidos em diferentes posições na árvore.

Os menus são os nós que ficam na raiz da árvore do catálogo.

● No sistema de administração, utilize o atalho “Árvore de temas”.

● O sistema abrirá a árvore no modo de edição. Ao expandir um nó é mostrada a opção

de adicionar um filho (grupo ou subgrupo). Os mapfiles podem ser adicionados abaixo
de um subgrupo ou na raiz de um menu ou grupo. Navegue pela árvore e localize a
opção “Adicionar um novo” que é mostrada logo abaixo de “Temas…”.
● Clique na opção “Adicionar um novo” para abrir o formulário.
● Uma lista de mapfiles é mostrada, onde pode ser visto também o seu título. Escolha o
desejado. Em “Publicado?” marque como “sim” e salve. Para voltar a abrir o formulário,
basta acionar o ícone “Editar”

● Basta agora abrir o i3geo e verificar se o tema está sendo mostrado corretamente na
árvore do catálogo.