i3geo/classesjs/classe_navega.js
GPL2
i3Geo Interface Integrada de Ferramentas de Geoprocessamento para Internet
Direitos Autorais Reservados © 2006 Ministério do Meio Ambiente Brasil Desenvolvedor: Edmar Moretti edmar.moretti@gmail.com
Este programa é software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos da Licença Pública Geral GNU conforme publicada pela Free Software Foundation;
Este programa é distribuído na expectativa de que seja útil, porém, SEM NENHUMA GARANTIA; nem mesmo a garantia implícita de COMERCIABILIDADE OU ADEQUACÃO A UMA FINALIDADE ESPECÍFICA. Consulte a Licença Pública Geral do GNU para mais detalhes. Você deve ter recebido uma cópia da Licença Pública Geral do GNU junto com este programa; se não, escreva para a Free Software Foundation, Inc., no endereço 59 Temple Street, Suite 330, Boston, MA 02111-1307 USA.
| Navegação sobre o mapa | i3geo/classesjs/classe_navega.js | 
| i3GEO. | Realiza operações de navegação do mapa, como zoom, pan, etc.. | 
| Propriedades | |
| TEMPONAVEGAR | Tempo em milisegundos que será esperado para executar uma operação de navegação sobre o mapa. | 
| FATORZOOM | Valor utilizado nas operações de zoom in e out. | 
| Variaveis | |
| timerNavega | Objeto do tipo timer utilizado no contador de tempo para o delay de execução das funções de navegação | 
| Functions | |
| centroDoMapa | Obtém as coordenadas geográficas do centro do mapa | 
| zoomin | Aproxima o mapa aplicando um fator de modificação da escala | 
| zoomout | Afasta o mapa aplicando um fator de modificação da escala | 
| zoomponto | Centraliza o mapa em um ponto e acrescenta o ponto como uma nova camada no mapa | 
| zoompontoIMG | Centraliza o mapa em um ponto de coordenadas medidas na imagem do mapa | 
| xy2xy | Desloca o mapa de um ponto de coordenadas xy para um segundo ponto | 
| localizaIP | Localiza as coordenadas baseadas no número IP do usuário. | 
| zoomIP | Mostra no mapa um ponto baseado na localização do usuário. | 
| zoomExt | Aplica uma nova extensão geográfica ao mapa. | 
| aplicaEscala | Aplica ao mapa um novo valor de escala tendo como base o valor do denminador | 
| panFixo | Desloca o mapa para uma determinada direção com uma distância fixa. | 
| panFixoNorte | Desloca o mapa para o norte | 
| panFixoSul | Desloca o mapa para o sul | 
| panFixoOeste | Desloca o mapa para o oeste | 
| panFixoLeste | Desloca o mapa para o leste | 
| mostraRosaDosVentos | Mostra sobre o mapa a rosa dos ventos. | 
| i3GEO. | Controla o redesenho automático do mapa por meio de um temporizador | 
| Propriedades | |
| INTERVALO | Intervalo de tempo, em milisegundos, que será utilizado para disparar o desenho do mapa | 
| Variaveis | |
| ID | Guarda o valor do ID do elemento HTML que receberá o contador de tempo | 
| Functions | |
| ativa | Ativa o auto-redesenho do mapa | 
| desativa | Desativa o auto-redesenho do mapa | 
| redesenha | Redesenha o mapa quando o contador de tempo chegar a zero | 
| contagem | Faz a contagem do tempo | 
| i3GEO. | Controla o desenho de um box na tela para executar o zoom por box | 
| Functions | |
| inicia | Marca o início do desenho do box, capturando a posição do mouse | 
| criaBox | Cria o DIV que será utilizado para desenhar o box no mapa | 
| desloca | Desloca o box conforme o mouse é movimentado | 
| termina | Para o desenho do box, captura seu tamanho e faz o zoom no mapa | 
| i3GEO. | Ativa e controla a lente de aumento. | 
| Propriedades | |
| POSICAOX | Define a posição em x da lente em relação ao corpo do mapa | 
| POSICAOY | Define a posição em y da lente em relação ao corpo do mapa | 
| Variaveis | |
| ESTAATIVA | Indica se a lente foi ou não aberta | 
| Functions | |
| inicia | Ativa a lente de aumento criando os elementos gráficos necessários e ativando os eventos que controlam a apresentação da lente | 
| atualiza | Atualiza a imagem da lente aberta | 
| desativa | Desativa alente aberta | 
| movimenta | Movimenta a imagem dentro da lente para refletir a posição do mouse | 
| i3GEO. | Destaca um tema mostrando-o sobre os outros em um box que segue o mouse | 
| Propriedades | |
| TAMANHO | Tamanho do box | 
| Functions | |
| inicia | Inicia o destaque de um tema | 
| atualiza | Atualiza o destaque | 
| desativa | Desativa o destaque | 
| movimenta | Movimenta o destaque conforme o mouse move | 
| i3GEO. | Controla a barra (slide) de zoom | 
| Functions | |
| cria | Cria os elementos HTML para a barra de zoom | 
| ativa | Ativa os botões da barra de zoom | 
| i3GEO. | Abre as telas de diálogo das opções de navegação no mapa atual | 
| Functions | |
| wiki | Abre a janela de diálogo da ferramenta wiki permitindo a navegação integrada com a Wikipédia | 
| metar | Abre a janela de diálogo da ferramenta metar permitindo a navegação integrada com a rede de dados meteorológicos | 
| buscaFotos | Abre a janela de diálogo da ferramenta metar permitindo a navegação integrada com serviços de armazenamento de fotografias | 
| Abre a janela de diálogo da ferramenta google permitindo a navegação integrada com o GoogleMaps | |
| confluence | Abre a janela de diálogo da ferramenta confluence permitindo a navegação integrada com a localização de confluências | 
Realiza operações de navegação do mapa, como zoom, pan, etc..
Quando todos os argumentos da função forem opcionais, basta usar nomeFuncao(), nos casos em que os primeiros argumentos forem opcionais e os demais obrigatórios, utilize “” no lugar do argumento que se quer usar o default, exemplo, nomeFuncao(“”,””,10)
| Propriedades | |
| TEMPONAVEGAR | Tempo em milisegundos que será esperado para executar uma operação de navegação sobre o mapa. | 
| FATORZOOM | Valor utilizado nas operações de zoom in e out. | 
| Variaveis | |
| timerNavega | Objeto do tipo timer utilizado no contador de tempo para o delay de execução das funções de navegação | 
| Functions | |
| centroDoMapa | Obtém as coordenadas geográficas do centro do mapa | 
| zoomin | Aproxima o mapa aplicando um fator de modificação da escala | 
| zoomout | Afasta o mapa aplicando um fator de modificação da escala | 
| zoomponto | Centraliza o mapa em um ponto e acrescenta o ponto como uma nova camada no mapa | 
| zoompontoIMG | Centraliza o mapa em um ponto de coordenadas medidas na imagem do mapa | 
| xy2xy | Desloca o mapa de um ponto de coordenadas xy para um segundo ponto | 
| localizaIP | Localiza as coordenadas baseadas no número IP do usuário. | 
| zoomIP | Mostra no mapa um ponto baseado na localização do usuário. | 
| zoomExt | Aplica uma nova extensão geográfica ao mapa. | 
| aplicaEscala | Aplica ao mapa um novo valor de escala tendo como base o valor do denminador | 
| panFixo | Desloca o mapa para uma determinada direção com uma distância fixa. | 
| panFixoNorte | Desloca o mapa para o norte | 
| panFixoSul | Desloca o mapa para o sul | 
| panFixoOeste | Desloca o mapa para o oeste | 
| panFixoLeste | Desloca o mapa para o leste | 
| mostraRosaDosVentos | Mostra sobre o mapa a rosa dos ventos. | 
zoomponto: function( locaplic, sid, x, y, tamanho, simbolo, cor ) 
Centraliza o mapa em um ponto e acrescenta o ponto como uma nova camada no mapa
| locaplic {String} | (opcional) endereço do i3geo utilizado na geração da URL para fazer a chamada AJAX | 
| sid {String} | (opcional) código da seção aberta no servidor pelo i3geo | 
| x {Numeric} | coordenada em décimos de grau da longitude | 
| y {Numeric} | coordenada em décimos de grau da latitude | 
| tamanho {Numeric} | opcional, tamanho do símbolo do ponto que será inserido no mapa | 
| simbolo {String} | opcional, nome do símbolo para o ponto | 
| cor {String} | opcional, cor em r g b (p.ex. “255 0 0”) | 
zoompontoIMG: function( locaplic, sid, x, y ) 
Centraliza o mapa em um ponto de coordenadas medidas na imagem do mapa
| locaplic {String} | (opcional) endereço do i3geo utilizado na geração da URL para fazer a chamada AJAX | 
| sid {String} | (opcional) código da seção aberta no servidor pelo i3geo | 
| x {Numeric} | coordenada x da imagem | 
| y {Numeric} | coordenada y da imagem | 
xy2xy: function( locaplic, sid, xi, yi, xf, yf, ext, tipoimagem ) 
Desloca o mapa de um ponto de coordenadas xy para um segundo ponto
| locaplic {String} | (opcional) endereço do i3geo utilizado na geração da URL para fazer a chamada AJAX | 
| sid {String} | (opcional) código da seção aberta no servidor pelo i3geo | 
| xi {Numeric} | coordenada x inicial | 
| yi {Numeric} | coordenada y inicial | 
| xf {Numeric} | coordenada x final | 
| yf {Numeric} | coordenada y final | 
| ext {String} | extensão geográfica do mapa | 
| tipoimagem {String} | tipo de imagem atual do mapa (sepia,nenhum,cinza) | 
localizaIP: function( locaplic, sid, funcao ) 
Localiza as coordenadas baseadas no número IP do usuário.
| locaplic {String} | (opcional) endereço do i3geo utilizado na geração da URL para fazer a chamada AJAX | 
| sid {String} | (opcional) código da seção aberta no servidor pelo i3geo | 
| funcao {Function} | função que será executada ao concluir a chamada AJAX. Essa função receberá o objeto JSON obtido. | 
zoomExt: function( locaplic, sid, tipoimagem, ext ) 
Aplica uma nova extensão geográfica ao mapa.
| locaplic {String} | (opcional) endereço do i3geo utilizado na geração da URL para fazer a chamada AJAX | 
| sid {String} | (opcional) código da seção aberta no servidor pelo i3geo | 
| tipoimagem {String} | Utlize “” para aplicar o default. Tipo de imagem que será retornada na imagem do mapa que será criada | 
| ext {String} | Extensão geográfica no formato xmin ymin xmax ymax | 
aplicaEscala: function( locaplic, sid, escala ) 
Aplica ao mapa um novo valor de escala tendo como base o valor do denminador
Utilize “” caso vc queira usar locaplic e sid default.
| locaplic {String} | endereço do i3geo utilizado na geração da URL para fazer a chamada AJAX. Pode ser “” | 
| sid {String} | código da seção aberta no servidor pelo i3geo. pode ser “” | 
| escala {Numeric} | denominador da escala | 
panFixo: function( locaplic, sid, direcao, w, h, escala ) 
Desloca o mapa para uma determinada direção com uma distância fixa.
| locaplic {String} | (opcional) endereço do i3geo utilizado na geração da URL para fazer a chamada AJAX | 
| sid {String} | (opcional) código da seção aberta no servidor pelo i3geo | 
| direcao {String} | norte,sul,leste,oeste,sudeste,sudoeste,nordeste,noroeste | 
| w {Numeric} | largura da imagem do mapa em pixels | 
| h {Numeric} | altura da imagem do mapa em pixels | 
| escala {Numeric} | escala do mapa | 
mostraRosaDosVentos: function() 
Mostra sobre o mapa a rosa dos ventos.
A rosa permite que o usuário navegue no mapa sem ter de alterar a opção atual de navegação.
A rosa é mostrada apenas se a variável i3GEO.configura.mostraRosaDosVentos for = a “sim”.<b>
Para que a rosa seja mostrada, é necessário que esta função esteja registrada em
i3GEO.eventos.MOUSEPARADO
Controla o redesenho automático do mapa por meio de um temporizador
| Propriedades | |
| INTERVALO | Intervalo de tempo, em milisegundos, que será utilizado para disparar o desenho do mapa | 
| Variaveis | |
| ID | Guarda o valor do ID do elemento HTML que receberá o contador de tempo | 
| Functions | |
| ativa | Ativa o auto-redesenho do mapa | 
| desativa | Desativa o auto-redesenho do mapa | 
| redesenha | Redesenha o mapa quando o contador de tempo chegar a zero | 
| contagem | Faz a contagem do tempo | 
Ativa e controla a lente de aumento.
A lente de aumento é um box que pode ser ativado sobre o mapa mostrando uma imagem ampliada da região onde está o mouse
| Propriedades | |
| POSICAOX | Define a posição em x da lente em relação ao corpo do mapa | 
| POSICAOY | Define a posição em y da lente em relação ao corpo do mapa | 
| Variaveis | |
| ESTAATIVA | Indica se a lente foi ou não aberta | 
| Functions | |
| inicia | Ativa a lente de aumento criando os elementos gráficos necessários e ativando os eventos que controlam a apresentação da lente | 
| atualiza | Atualiza a imagem da lente aberta | 
| desativa | Desativa alente aberta | 
| movimenta | Movimenta a imagem dentro da lente para refletir a posição do mouse | 
Abre as telas de diálogo das opções de navegação no mapa atual
| Functions | |
| wiki | Abre a janela de diálogo da ferramenta wiki permitindo a navegação integrada com a Wikipédia | 
| metar | Abre a janela de diálogo da ferramenta metar permitindo a navegação integrada com a rede de dados meteorológicos | 
| buscaFotos | Abre a janela de diálogo da ferramenta metar permitindo a navegação integrada com serviços de armazenamento de fotografias | 
| Abre a janela de diálogo da ferramenta google permitindo a navegação integrada com o GoogleMaps | |
| confluence | Abre a janela de diálogo da ferramenta confluence permitindo a navegação integrada com a localização de confluências | 
Obtém as coordenadas geográficas do centro do mapa
centroDoMapa: function() 
Aproxima o mapa aplicando um fator de modificação da escala
zoomin: function( locaplic, sid ) 
Afasta o mapa aplicando um fator de modificação da escala
zoomout: function( locaplic, sid ) 
Centraliza o mapa em um ponto e acrescenta o ponto como uma nova camada no mapa
zoomponto: function( locaplic, sid, x, y, tamanho, simbolo, cor ) 
Centraliza o mapa em um ponto de coordenadas medidas na imagem do mapa
zoompontoIMG: function( locaplic, sid, x, y ) 
Desloca o mapa de um ponto de coordenadas xy para um segundo ponto
xy2xy: function( locaplic, sid, xi, yi, xf, yf, ext, tipoimagem ) 
Localiza as coordenadas baseadas no número IP do usuário.
localizaIP: function( locaplic, sid, funcao ) 
Mostra no mapa um ponto baseado na localização do usuário.
zoomIP: function( locaplic, sid ) 
Aplica uma nova extensão geográfica ao mapa.
zoomExt: function( locaplic, sid, tipoimagem, ext ) 
Aplica ao mapa um novo valor de escala tendo como base o valor do denminador
aplicaEscala: function( locaplic, sid, escala ) 
Desloca o mapa para uma determinada direção com uma distância fixa.
panFixo: function( locaplic, sid, direcao, w, h, escala ) 
Desloca o mapa para o norte
panFixoNorte: function() 
Desloca o mapa para o sul
panFixoSul: function() 
Desloca o mapa para o oeste
panFixoOeste: function() 
Desloca o mapa para o leste
panFixoLeste: function() 
Mostra sobre o mapa a rosa dos ventos.
mostraRosaDosVentos: function() 
Ativa o auto-redesenho do mapa
ativa: function( id ) 
Desativa o auto-redesenho do mapa
desativa:function() 
Redesenha o mapa quando o contador de tempo chegar a zero
redesenha: function() 
Faz a contagem do tempo
contagem: function() 
Marca o início do desenho do box, capturando a posição do mouse
inicia: function() 
Cria o DIV que será utilizado para desenhar o box no mapa
criaBox: function() 
Desloca o box conforme o mouse é movimentado
desloca: function() 
Para o desenho do box, captura seu tamanho e faz o zoom no mapa
termina: function() 
Ativa a lente de aumento criando os elementos gráficos necessários e ativando os eventos que controlam a apresentação da lente
inicia: function() 
Atualiza a imagem da lente aberta
atualiza: function() 
Desativa alente aberta
desativa: function() 
Movimenta a imagem dentro da lente para refletir a posição do mouse
movimenta: function() 
Inicia o destaque de um tema
inicia: function( tema ) 
Atualiza o destaque
atualiza: function() 
Desativa o destaque
desativa: function() 
Movimenta o destaque conforme o mouse move
movimenta: function() 
Cria os elementos HTML para a barra de zoom
cria: function() 
Ativa os botões da barra de zoom
ativa: function() 
Abre a janela de diálogo da ferramenta wiki permitindo a navegação integrada com a Wikipédia
wiki: function() 
Abre a janela de diálogo da ferramenta metar permitindo a navegação integrada com a rede de dados meteorológicos
metar: function() 
Abre a janela de diálogo da ferramenta metar permitindo a navegação integrada com serviços de armazenamento de fotografias
buscaFotos: function() 
Abre a janela de diálogo da ferramenta google permitindo a navegação integrada com o GoogleMaps
google: function( coordenadas ) 
Abre a janela de diálogo da ferramenta confluence permitindo a navegação integrada com a localização de confluências
confluence: function()