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 Revertidas edições por Edmar.moretti (discussão) para a última versão por Marcos Antônio Nunes de Moura |
Sem resumo de edição |
||
Linha 27:
*php_mbstring
*php_gd
*php_xmlrpc
*php_xsl
Linha 65:
*symbols: arquivos com a simbologia utilizada na representação dos temas no mapa.
*temas: arquivos .map correspondentes aos temas disponíveis para inclusão no mapa.
*exemplos: arquivos com exemplos de uso e customização do I3Geo.
==Utilização do R==
=Configuração=
Linha 197 ⟶ 200:
Na versão 3.3 do I3Geo, os temas podem ser incluídos fora dos grupos e subgrupos, ou seja, podem existir temas sem '''pai''' na hierarquia do XML.
O arquivo com os temas é também utilizado pelo programa i3geo/ogc.php, que gera 'WEB Services' nos padrões [http://www.opengeospatial.org/ OGC], automaticamente. Se vc não deseja que determinado tema seja incluído na lista de camadas dos web services, é necessário incluir nesse tema o item:
<OGC>nao</OGC>
Você pode também criar perfis, assim os temas serão mostrados no menu apenas quando o perfil for o mesmo da variável de inicialização 'perfil'. Para utilizar um perfil, basta acrescentar o item <PERFIL>, como mostrado abaixo:
menutemas/menutemas.xml, para que a nova camada fique disponível no menu de adição de temas.
O arquivo '''menutemas.xml''' utiliza o formato '''XML''', podendo ser manipulado com qualquer editor de textos. Como '''XML''', a estrutura do texto deve ser bem formada, respeitando-se a hierarquia de itens e seu correto fechamento, como no exemplo abaixo:
<?xml version="1.0" encoding="ISO-8859-1"?>
<?xml-stylesheet type="text/xsl" href="menutemas.xsl"?>
<TEMASGEO>
<CABECALHO></CABECALHO>
<GRUPO>
<GTIPO>Base cartográfica</GTIPO>
<DTIPO>Rios, estradas, relevo, etc. com abrangência contínua</DTIPO>
<SGRUPO>
<SDTIPO>Hidrografia</SDTIPO>
<TEMA>
<TID>hidrografia</TID>
<TNOME>Hidrografia</TNOME>
<TDESC>Rios, lagos e elementos associados. O conteúdo apresentado depende da escala.</TDESC>
</TEMA>
</SGRUPO>
<SGRUPO>
<SDTIPO>Transporte</SDTIPO>
<TEMA>
<TID>transporte</TID>
<TNOME>Transporte</TNOME>
<TDESC>Rodovias, ferrovias e elementos associados. O conteúdo apresentado depende da scala.</TDESC>
<TLINK>mapas.mma.gov.br</TLINK>
</TEMA>
</SGRUPO>
</GRUPO>
</TEMASGEO>
O XML é organizado em grupos, subgrupos e temas, sendo que em cada nível existem atributos específicos, como mostrado abaixo:
<TEMASGEO>
<GRUPO>
<GTIPO>Nome do grupo</GTIPO>
<DTIPO>Descrição do grupo</DTIPO>
<SGRUPO>
<SDTIPO>Nome do subgrupo</SDTIPO>
<PERFIL>a,b</PERFIL>
<TEMA>
<PERFIL>a</PERFIL>
<TID>ID do tema, corresponde ao nome do mapfile criado, sem a extensão “.map” </TID>
<TNOME>nome longo do tema</TNOME>
<TDESC>descrição do tema</TDESC>
<TLINK>link para a fonte ou outra informação adicional sobre o tema. Será mostrado como um link no menu de adição de temas</TLINK>
<DOWNLOAD>opcional, escreva SIM aqui para que esse tema seja mostrado na lista de temas para download</DOWNLOAD>
</TEMA>
<TEMA>
<PERFIL>b</PERFIL>
<TID>ID do tema, corresponde ao nome do mapfile criado, sem a extensão “.map” </TID>
<TNOME>nome longo do tema</TNOME>
<TDESC>descrição do tema</TDESC>
<TLINK>link para a fonte ou outra informação adicional sobre o tema. Será mostrado como um link no menu de adição de temas</TLINK>
<DOWNLOAD>opcional, escreva SIM aqui para que esse tema seja mostrado na lista de temas para download</DOWNLOAD>
</TEMA>
</SGRUPO>
</GRUPO>
</TEMASGEO>
Os perfis podem ser incluídos em qualquer nível, ou seja, subgrupo e tema. Para indicar o perfil para o I3Geo, na inicialização deve-se usar a variável &perifl, exemplo:
i3geo/ms_criamapa.php?perfil=a
==Inclusão de endereços para conexão remota==
Linha 223 ⟶ 296:
<SISTEMA>
<NOMESIS>SIGEPRO - ações do MMA</NOMESIS>
<PERFIL></PERFIL>
<FUNCAO>
<NOMEFUNCAO>Compor mapa</NOMEFUNCAO>
Linha 228 ⟶ 302:
<JANELAW>500</JANELAW>
<JANELAH>400</JANELAH>
<PERFIL></PERFIL>
</FUNCAO>
</SISTEMA>
Linha 235 ⟶ 310:
Como pode-se observar no exemplo acima, é possível a inclusão de dois níveis na árvore que aparece no menu. O primeiro nível é nominado pelo item <NOMESIS> e o segundo por <NOMEFUNCAO>. Para cada novo grupo de aplicações, é necessário incluir um item <SISTEMA> </SISTEMA> e para cada nova função um item <FUNCAO></FUNCAO>. Quando uma função é escolhida pelo usuário, o programa indicado em <ABRIR> é executado em uma janela integrada no i3Geo, os itens <JANELAW> e <JANELAH> controlam o tamanho dessa janela (largura e altura respectivamente).
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==
Linha 247 ⟶ 324:
<NOMESIS>SIGEPRO</NOMESIS>
<ABRIR>"http://endereco/r.php?x="+xpt+"&y="+ypt</ABRIR>
<TARGET>pode ser self ou blank</TARGET>
</FUNCAO>
</SISTEMAS>
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 vc pode acrescentar outras fontes. Para isso, vc deve:
*Copiar o arquivo com a fonte no diretório symbols.
*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.
Essa característica, apesar de não representar problemas de segurança, pode não ser desejada em algumas situações.
O I3Geo, a partir da versão 3.6, implementa um esquema que possibilita esconder a string de conexão em bancos Postgis. Para que isso ocorra, é necessário incluir no arquivo ms_configura.php a varíável $postgis_mapa, como por exemplo:
$postgis_mapa = "user=geo password=geo dbname=geo host=localhost port=5432";
Caso não exista a necessidade de implementar esse esquema de substituição, deve-se manter a variável como:
$postgis_mapa = "";
Além dessa variável, é necessário excluir dos arquivos mapfile (existentes em i3geo/temas) a string de conexão, por exemplo:
CONNECTION " "
=Programas especiais=
Linha 267 ⟶ 369:
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.
Ao iniciar o mapa, são criados diretórios temporários no endereço de arquivos temporários do Mapserver. Nesses diretórios são copiados os arquivos necessários para o funcionamento do i3geo, principalmente o arquivo 'mapfile' inicial (por padrão 'aplicmap/geral1.map' ou 'aplicmap/geral1windows.map'). As funções do mapa interativo utilizam esse 'mapfile' temporário para recuperar os parâmetros necessários ao desenho do mapa.
Esse esquema garante uma grande flexibilidade para a aplicação, pois qualquer função de processamento pode ler e gravar no arquivo de mapa temporário, não havendo interferências entre mapas ou limites quanto ao número de temas disponíveis ao usuário.
Linha 273 ⟶ 375:
Exemplos:
*Inicialização normal: utiliza os parâmetros padrão
mapas.mma.gov.br/i3geo/ms_criamapa.php
*Inicialização com debug: ativa o modo de debug nos programas em PHP que rodam no servidor. Isso permite o uso de programas como o Firebug, do Firefox, para verificação mais detalhada de erros
mapas.mma.gov.br/i3geo/ms_criamapa.php?debug=sim
*Inicialização com temas adicionais: abre o mapa já com alguns temas incluídos
mapas.mma.gov.br/i3geo/ms_criamapa.php?temasa=bioma estadosl
*Inicialização com temas adicionais e temas visíveis: inclui temas e torna-os visíveis
mapas.mma.gov.br/i3geo/ms_criamapa.php?temasa=bioma estadosl&layers=bioma
*Inicialização enquadrando o mapa: altera a extensão geográfica padrão
mapas.mma.gov.br/i3geo/ms_criamapa.php?temasa=bioma estadosl&layers=bioma
&mapext=-61.659833758812 -22.167229487155 -51.653964228299 -14.563251436222
*Inicialização adicionando pontos: mostra pontos no mapa
mapas.mma.gov.br/i3geo/ms_criamapa.php?temasa=bioma estadosl&layers=bioma
&mapext=-61.659833758812 -22.167229487155 -51.653964228299 -14.563251436222
&pontos=-56 -18&nometemapontos=Tema de pontos
*Inicialização com uma interface diferente: utiliza uma "cara" diferente para o mapa
mapas.mma.gov.br/i3geo/ms_criamapa.php?interface=../mapas/aplic/atlasrh/mapa.htm
&caminho=/opt/www/html/i3geo/&temasa=/opt/www/html/mapas/aplic/atlasrh/mapa.map estadosl
&mapext=-54.397381965334 -21.003355295685 -27.646996077635 -0.67435275135509
*Mapfile diferente: utiliza um mapfile específico na inicialização
mapas.mma.gov.br/i3geo/ms_criamapa.php?base=teste
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==
Linha 316 ⟶ 433:
12.Salva o 'mapfile' temporário.
13.Verifica se existe algum programa ou função que deve ser executado sobre o arquivo 'mapfile' criado (parâmetro de inicialização executa).
14. Caso existam programas, os mesmos são incluídos. Esses programas podem operar sobre o arquivo 'mapfile' criado (variável $tmpfname).
Linha 349 ⟶ 466:
A inclusão dos links para os serviços utiliza o padrão RSS, dessa forma, os serviços de cada instituição podem ser incluídos e atualizados permanentemente.
Para acessar o cliente utilize o endereço
http:// 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
O endereço para acesso é:
http://
==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:
http://mapas.mma.gov.br/i3geo/ogc.php?ajuda=sim
O endereço do web service é
http://mapas.mma.gov.br/i3geo/ogc.php
Caso vc queira um web service de um tema específico, utilize:
http://mapas.mma.gov.br/i3geo/ogc.php?tema=codigo_do_tema
O código do tema corresponde ao código existente no arquivo menutemas.xml.
Para evitar que um número muito grande de temas seja incluido, vc pode especificar um range, por exemplo:
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.
Exemplo:
http://mapas.mma.gov.br/i3geo/geradordelinks.htm
=FAQ=
| |||