I3geo/Instalação: diferenças entre revisões
| [edição não verificada] | [edição não verificada] |
Conteúdo apagado Conteúdo adicionado
m I3geo:ajuda i3geo:instalação movido para I3geo/Instalação: formatação com barra |
adição (contéudo movido de I3geo:ajudai3geo:camadas:exemplos); formatação |
||
Linha 1:
<p align="right">[[i3geo
==Instalação==
===Download===
O I3Geo pode ser obtido no endereço:
http://mapas.mma.gov.br/download
Linha 11:
O '''ms4w''' ([http://www.maptools.org/ms4w/index.phtml veja]) é um pacote para Windows que traz o Apache, PHP e Mapserver já instalados, bastando copiar a pasta '''ms4w''' para o diretório local (drive c:).
===Requisitos para instalação===
Os seguintes softwares são necessários para o correto funcionamento do I3Geo:
Linha 31:
*php_xsl
===Instalação padrão===
O uso da instalação padrão é recomendado quando não é desejado alterar os arquivos originais do I3Geo, o que simplifica a instalação. No caso de já existir um servidor de internet, ou a estrutura de diretórios da instalação padrão não ser adequada, pode-se optar pela alteração desses arquivos.
Linha 41:
No sistema operacional Linux a instalação dos softwares necessários ao funcionamento do I3Geo devem estar prontos no computador. Tendo esses softwares funcionando, crie o diretório /opt/www/html e copie o diretório '''i3geo''', existente no arquivo zip, para esse diretório. Crie também o diretório /var/tmp/ms_tmp, dando direito de escrita e leitura para os grupos necessários a operação do Apache.
O diretório ms_tmp é utilizado pelo Mapserver para o armazenamento de arquivos de desenho do mapa, devendo estar disponível ao servidor web Apache para escrita e leitura. É necessário também editar os arquivos '''php.ini''' e '''httpd.conf''', adaptando-os para os novos diretórios. Basicamente, o servidor Apache precisa reconhecer o diretório /opt/www/html como a raiz dos documentos ''web''. Em muitas instalações pode ocorrer do servidor web não reconhecer o diretório ms_tmp como um diretório válido. Nesse caso, uma alternativa é criar um ''link'' simbólico dentro do diretório 'html' apontando para o ms_tmp.
===Instalação específica===
O I3Geo pode ser instalado em um diretório diferente do indicado no tópico anterior. Nesse caso, são necessárias alterações em alguns arquivos para que o local de instalação seja reconhecido. Essas alterações estão documentadas nos próprios arquivos listados abaixo.
Linha 51:
*i3geo/aplicmapa/geral.htm
===Descrição dos diretórios===
O diretório i3geo contém os seguintes sub-diretórios:
Linha 67:
*exemplos: arquivos com exemplos de uso e customização do I3Geo.
===Utilização do R===
==Configuração==
===Inclusão de temas (camadas)===
Alguns arquivos no formato '''shape file''' são fornecidos junto com o I3Geo possibilitando a geração de um mapa do Brasil. Esses dados são utilizados apenas para demonstrar que o mapa interativo está funcionando, devendo ser feita a adequação dos mesmos para atender as necessidades dos usuários do sítio que está sendo construído.
Linha 78:
Tendo os dados preparados e organizados, seja na forma de arquivos ou bancos de dados, é possível incluir no menu de adição de temas as camadas desejadas. Para isso, é necessário a criação de arquivos do tipo '''mapfile''', que definem os parâmetros de apresentação de uma camada, e a organização desses no arquivo XML usado pelo I3Geo na apresentação do menu.
====Configuração de uma camada====
Para cada nova camada a ser incluída no I3Geo, deve-se criar um arquivo '''mapfile''' e armazená-lo no diretório i3geo\temas.
Linha 141:
END
====Mais exemplos====
=====Conexão com PostGis e mais de uma classe=====
SYMBOLSET ../symbols/simbolos.sym
FONTSET "../symbols/fontes.txt"
LAYER
NAME bioma # ok
TYPE Polygon
STATUS OFF
TEMPLATE "none.htm"
CONNECTIONTYPE postgis
CONNECTION "user=geodados password=geodados dbname=geodados host=10.1.1.36 port=5432"
DATA "the_geom FROM (select * FROM brasil.brareg1) as foo USING UNIQUE gid USING SRID=4291"
METADATA
ITENS "cd_legenda"
ITENSDESC "Nome"
TEMA "Bioma"
CLASSE "SIM"
ESCALA "5000000"
END
TRANSPARENCY 80
CLASS
Name 'Amazônia'
EXPRESSION ('[id]'eq '1')
COLOR 255 255 204
OUTLINECOLOR 50 50 50
END # CLASS
CLASS
Name 'Caatinga'
EXPRESSION ('[id]'eq '2')
COLOR 232 220 201
OUTLINECOLOR 50 50 50
END # CLASS
CLASS
Name 'Cerrado'
EXPRESSION ('[id]'eq '3')
COLOR 244 214 0
OUTLINECOLOR 50 50 50
END # CLASS
CLASS
Name 'Pantanal'
EXPRESSION ('[id]'eq '6')
COLOR 200 200 241
OUTLINECOLOR 50 50 50
END # CLASS
CLASS
Name 'Pampa'
EXPRESSION ('[id]'eq '5')
COLOR 143 189 192
OUTLINECOLOR 50 50 50
END # CLASS
CLASS
Name 'Mata Atlântica'
EXPRESSION ('[id]'eq '4')
COLOR 218 255 216
OUTLINECOLOR 50 50 50
END # CLASS
END
END
=====Conexão com PostGis e SQL mais complexo=====
SYMBOLSET ../symbols/simbolos.sym
FONTSET "../symbols/fontes.txt"
LAYER
NAME escolastups # ok
TYPE point
STATUS off
CONNECTIONTYPE postgis
CONNECTION "user=geodados password=geodados dbname=geodados host=10.1.1.36 port=5432"
DATA "the_geom FROM (select the_geom,gid from public.censoescolar2006 as escolas,brasil.bracom5 as tups
where escola_enderecocep = logradouro_cep and telefone_publico = num_fonepub1)
as foo USING UNIQUE gid USING SRID=4291"
TEMPLATE "none.htm"
METADATA
TEMA "Escolas"
CLASSE "SIM"
ESCALA "250000"
END
TRANSPARENCY 100
CLASS
NAME ' '
symbol "ponto"
size 4
COLOR 255 0 0
END
END
=====Imagem de satélite=====
SYMBOLSET ../symbols/simbolos.sym
FONTSET "../symbols/fontes.txt"
LAYER
NAME bluemarble # ok
TYPE RASTER
STATUS off
template "none.htm"
METADATA
TEMA "Blue Marble"
CLASSE "NAO"
ITENS "values,value_0,value_1,value_2"
ITENSDESC "Valores,Banda_1,Banda_2,Banda_3"
END
TRANSPARENCY 70
DATA brasil/modis/bluemarble_southamerica.tif
END
END
=====Conexão com WMS=====
SYMBOLSET ../symbols/simbolos.sym
FONTSET "../symbols/fontes.txt"
LAYER
NAME "biota"
TYPE RASTER
STATUS off
CONNECTION "http://saruman.cria.org.br/cgi-bin/mapserv?map=/var/www/wms/biota_wms.map"
CONNECTIONTYPE WMS
METADATA
"wms_srs" "EPSG:4326"
"wms_name" "biota_coletas_wms"
"wms_server_version" "1.1.0"
"wms_formatlist" "image/png"
"wms_format" "image/png"
"wms_connectiontimeout" "120"
TEMA "BIOTA - Coletas"
CLASSE "NAO"
END
TRANSPARENCY 100
END
END
=====Raster com tiles=====
LAYER
NAME raster25
TYPE RASTER
TILEINDEX "/opt/www/html/geodados/brasil/basecarto/cigex/25000/base/index.shp"
TILEITEM "LOCAL"
TEMPLATE "none.htm"
STATUS default
MAXSCALE 100000
METADATA
TEMA "Planialtimetria"
ITENS "value_0,value_1,value_2"
ITENSDESC "Nível 5,Nivel 4,Nivel 3"
CLASSE "SIM"
END
END
=====Transformação de polígono em centroide=====
SYMBOLSET "../symbols/simbolos.sym"
FONTSET "../symbols/fontes.txt"
LAYER
NAME quilombolas_muni # ok
TYPE point
STATUS off
CONNECTIONTYPE postgis
CONNECTION "user=geodados password=geodados dbname=geodados host=10.1.1.36 port=5432"
DATA "the_geom FROM (select brasil.bralim10.gid,centroid(brasil.bralim10.the_geom) as
the_geom,brasil.bralim10.geocodigo,brasil.bralim10.nome,brasil.bralim10.uf,
count(brasil.bralim14.municipio) as qtd from brasil.bralim10 LEFT JOIN brasil.bralim14 ON
(brasil.bralim10.geocodigo = brasil.bralim14.geocodigo) group by brasil.bralim10.gid,centroid
(brasil.bralim10.the_geom),brasil.bralim10.geocodigo,brasil.bralim10.nome,brasil.bralim10.uf
having count(brasil.bralim14.municipio) > 0) as foo USING UNIQUE gid USING SRID=4291"
TEMPLATE "none.htm"
METADATA
ITENS "geocodigo,nome,uf,qtd"
ITENSDESC "Cód. IBGE,Município,UF,Quantidade"
TEMA "Número Comunidades Quilombolas/Município"
CLASSE "SIM"
ESCALA ""
END
CLASS
NAME ' '
COLOR 252 18 18
OUTLINECOLOR 179 178 178
SIZE 4
SYMBOL "ponto"
END
END
END
====Inclusão de camadas no menu de temas====
Após a criação do arquivo '''.map''', com a representação do tema, é necessário editar o arquivo menutemas/menutemas.xml, para que a nova camada fique disponível no menu de adição de temas.
Linha 271 ⟶ 453:
i3geo/ms_criamapa.php?perfil=a
===Inclusão de endereços para conexão remota===
No menu de adição de temas do i3Geo existe uma opção que possibilita ao usuário acessar um tema a partir de uma conexão com um serviço no padrão OGC (WMS) e também via Geo RSS.
Linha 286 ⟶ 468:
Para incluir um serviço ou excluir, basta editar esse arquivo.
===Inclusão de aplicações que adicionam novas camadas===
No menu de adição de temas, após a árvore '''Temas''' é incluída a árvore '''sistemas'''. Nessa árvore são listados aplicativos que quando executados geram novas camadas de temas. Assim, é possível iniciar uma aplicação com diálogos e processos específicos para a adição de temas.
Linha 313 ⟶ 495:
Tanto no nível SISTEMA como em FUNCAO, pode-se incluir uma lista, separada por vírgulas, dos perfis de usuário que podem acessar o sistema ou função. O perfil do usuário atual do mapa é definido na inicialização do I3Geo.
===Inclusão de aplicações no menu de identificação===
De forma semelhante à inclusão de aplicações no menu de adição de temas, é possível incluir na janela de identificação opções que fazem um processamento especial tendo como base o ponto clicado no mapa.
Linha 330 ⟶ 512:
Observe que o programa “r.php” utiliza os parâmetros 'x' e 'y' que são obtidos das variáveis 'xpt' e 'ypt', fornecidas pelo próprio I3Geo.
===Fontes===
As fontes para o desenho de textos no mapa, são armazenadas no diretório '''symbols'''. As fontes distribuídas com o I3Geo são todas livres, mas você pode acrescentar outras fontes. Para isso, vc deve:
Linha 336 ⟶ 518:
*Editar o arquivo fontes.txt, acrescentando as novas fontes.
===Escondendo a string de conexão com o banco de dados===
Em função de uma característica do Mapserver, a string de conexão com o banco de dados é incluída no arquivo mapfile, ficando exposta e podendo ser visualizada em algumas situações.
Linha 354 ⟶ 536:
CONNECTION " "
==Programas especiais==
Programas criados para automatizar operações de manutenção do I3Geo:
Linha 360 ⟶ 542:
*testainstal.php: faz um teste básico da instalação do I3Geo.
==Documentação==
A documentação dos códigos do I3Geo utiliza o pacote '''NaturalDocs''' [www.naturaldocs.org ver]. Instale o NaturalDocs em c:\naturaldocs e execute o programa c:\ms4w\apache\htdocs\i3geo\documentacao\js\local.bat para atualizar a documentação.
==Atualização==
Para atualizar o I3Geo basta fazer o download da nova versão e copiar os arquivos para os locais adequados. Geralmente não se deve alterar os arquivos de configuração, como o ms_configura e aqueles existentes no diretório aplicmap. Para não perder o menu com os temas e os arquivos correspondentes aos temas, não sobreponha os diretórios menutemas e temas com a nova versão.
==Inicialização do I3Geo==
A inicialização do i3Geo é feita sempre pelo programa '''i3geo/ms_criamapa.php''', esse programa utiliza parâmetros de inicialização (ver documentação dos códigos PHP) que podem alterar a apresentação do mapa, tais como a extensão geográfica, temas já ativos, temas que iniciam de forma visível, etc.
Linha 407 ⟶ 589:
No diretório i3geo/exemplos existem alguns exemplos que mostram maneiras de customizar a iniciallização do I3Geo. Além dos links mostrados acima, é possível iniciallizar o I3Geo incluindo programas em PHP ou funções que serão executados. Um exemplo dessa forma de inicialização é mostrado em i3geo/exemplos/executafuncao.php.
===Processo de inicialização===
1.Inclui o arquivo de funções 'classesphp/funcoes_gerais.php'.
Linha 439 ⟶ 621:
15. Abre o mapa no navegador.
==Configuração da apresentação==
A apresentação do mapa é definida em arquivos HTML e CSS. Esses arquivos podem ser alterados ou criados outros para a customização da apresentação do mapa. Os arquivos CSS utilizados estão no diretório “css” e podem ser modificados conforme o desejado.
Linha 446 ⟶ 628:
Nesse arquivo HTML existem uma série de variáveis que podem alterar algumas características da interface, por exemplo, não abrir o mapa de referência, não abrir a janela de mensagens, iniciar com determinada guia aberta, etc.
===Acesso ao GoogleMaps===
Para que a ferramenta de integração com o Google Maps funcione, é necessário cadastrar o servidor onde está rodando o I3Geo no google [http://www.google.com/apis/maps/signup.html veja].
Linha 454 ⟶ 636:
file=api&v=1&key=digite_aqui_a_chave">
===Visualização em
A visualização em 3d (ou melhor, 2.5d) é ainda experimental no I3Geo. A sua implementação é baseada na criação de um arquivo wmrl no lado do servidor, após o arquivo ter sido gerado, é indicado o link para o usuário acessar o arquivo. Para que o modelo 3d possa ser visto, o usuário precisa ter instalado em sua máquina um programa ou plugin para o navegador de internet que estiver usando.
Para a geração do modelo wmrl, o I3Geo utiliza um arquivo .map que contém o tema com os valores de Z. O nome desse arquivo é definido na variável '''g_3dmap''' existente no arquivo aplicmap/geral.htm, por default, essa variável é definida como '''g_3dmap = "3dmap.map";'''.
==Sistemas integrados==
===Cliente de web service===
Com o "WSCliente" é possível acessar serviços que retornam dados textuais e mapas, sendo utilizado para cadastrar, divulgar e fornecer um meio rápido de verificação dos serviços disponíveis.
Linha 472 ⟶ 654:
Para incluir serviços na lista disponível veja a documentação incluída no próprio arquivo html.
===Download de dados===
Essa aplicação lê o arquivo '''menutemas.xml''' e lista os temas que permitem download. É uma aplicação útil para fornecer aos usuários o acesso aos dados. A aplicação pode ser configurada também para mostrar links para outras bases de dados, nesse caso, a lista de links pode ser mantida no arquivo '''menutemas/linksdownload.xml'''.
Linha 479 ⟶ 661:
http://mapas.mma.gov.br/i3geo/datadownload.htm
===Gerador automático de Web services OGC===
Com base nos temas incluídos no menutemas.xml, esse aplicativo gera automaticamente webservices no padrão OGC. Para ver a sintaxe desse programa, utilize:
Linha 498 ⟶ 680:
http://mapas.mma.gov.br/i3geo/ogc.php?intervalo=0,5
===Gerador de links===
O gerador de links é uma aplicação que possibilita ao usuário criar, de forma interativa, links customizados para abrir o I3Geo. Na interface pode-se escolher os temas que farão parte do mapa, definir a abrangência espacial, etc.
Linha 505 ⟶ 687:
http://mapas.mma.gov.br/i3geo/geradordelinks.htm
==FAQ==
====Eu posso alterar os códigos do I3Geo e redistribuí-lo?====
Sim. O I3Geo é licenciado como GPL, estando sujeito as regras desse tipo de licença.
====Como eu posso testar a instalação do I3Geo?====
Rode o programa i3geo/testainstal.php no seu navegador.
====Criei um tema mas não consigo ver no I3Geo, como posso testar esse tema?====
Rode o programa i3geo/testamapfile.php, disponível na versão 2.9.
====O I3Geo está abrindo corretamente, mas a imagem do mapa não aparece, qual o problema?====
Provavelmente o Apache não está reconhecendo o diretório ms_tmp como um diretório web. Crie um link simbólico no mesmo diretório onde está o i3geo apontando para o ms_tmp.
====Com o tempo o diretório ms_tmp fica cheio, o que devo fazer?====
O diretório ms_tmp é usado para armazenar os dados temporários de cada mapa, você deve apagá-lo de tempos em tempos, o que pode ser feito de forma automática, utilize algum programa do seu sistema operacional para programar essa limpeza.
====A opção de inclusão de textos não funciona====
Provavelmente as fontes existentes no diretório i3geo/symbols não são adequadas ao seu sistema operacional. Copie para esse diretório outras fontes existentes no seu sistema.
====A guia 'mapas' não mostra nada====
Edite o arquivo ms_configura e defina a variável de busca do arquivo xml para o local de sua instalação.
[[Categoria:I3geo|
| |||