Navegação sobre o mapa

Arquivo

i3geo/classesjs/classe_navega.js

Licenca

GPL2

I3Geo Interface Integrada de Ferramentas de Geoprocessamento para Internet

Direitos Autorais Reservados © 2006 Ministério do Meio Ambiente Brasil Desenvolvedor: Edmar Moretti edmar..nosp@m.moretti@mma.g.nosp@m.ov.br

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 ADEQUAÇÃ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.

Summary
Navegação sobre o mapai3geo/classesjs/classe_navega.js
i3GEO. navegaRealiza operações de navegação do mapa, como zoom, pan, etc..
Propriedades
TEMPONAVEGARTempo em milisegundos que será esperado para executar uma operação de navegação sobre o mapa.
FATORZOOMValor utilizado nas operações de zoom in e out.
Variaveis
timerNavegaObjeto do tipo timer utilizado no contador de tempo para o delay de execução das funções de navegação
Functions
zoominAproxima o mapa aplicando um fator de modificação da escala
zoomoutAfasta o mapa aplicando um fator de modificação da escala
zoompontoCentraliza o mapa em um ponto e acrescenta o ponto como uma nova camada no mapa
zoompontoIMGCentraliza o mapa em um ponto de coordenadas medidas na imagem do mapa
xy2xyDesloca o mapa de um ponto de coordenadas xy para um segundo ponto
localizaIPLocaliza as coordenadas baseadas no número IP do usuário.
zoomIPMostra no mapa um ponto baseado na localização do usuário.
zoomExtAplica uma nova extensão geográfica ao mapa.
aplicaEscalaAplica ao mapa um novo valor de escala tendo como base o valor do denminador
panFixoDesloca o mapa para uma determinada direção com uma distância fixa.
panFixoNorteDesloca o mapa para o norte
panFixoSulDesloca o mapa para o sul
panFixoOesteDesloca o mapa para o oeste
panFixoLesteDesloca o mapa para o leste
mostraRosaDosVentosMostra sobre o mapa a rosa dos ventos.
i3GEO. navega. autoRedesenhoControla o redesenho automático do mapa por meio de um temporizador
Propriedades
INTERVALOIntervalo de tempo, em milisegundos, que será utilizado para disparar o desenho do mapa
Variaveis
IDGuarda o valor do ID do elemento HTML que receberá o contador de tempo
Functions
ativaAtiva o auto-redesenho do mapa
desativaDesativa o auto-redesenho do mapa
redesenhaRedesenha o mapa quando o contador de tempo chegar a zero
contagemFaz a contagem do tempo
i3GEO. navega. zoomBoxControla o desenho de um box na tela para executar o zoom por box
Functions
iniciaMarca o início do desenho do box, capturando a posição do mouse
criaBoxCria o DIV que será utilizado para desenhar o box no mapa
deslocaDesloca o box conforme o mouse é movimentado
terminaPara o desenho do box, captura seu tamanho e faz o zoom no mapa
i3GEO. navega. entornoControla o desenho do entorno do mapa (modo tile)
Functions
ativaDesativaAjusta o mapa para ativar ou desativar o desenho do entorno
geraURLGera as URLs que serão utilizadas na tag IMG dos elementos do entorno do mapa
ajustaPosicaoAjusta a posição das imagens do entorno do mapa
i3GEO. navega. lenteAtiva e controla a lente de aumento.
Propriedades
POSICAOXDefine a posição em x da lente em relação ao corpo do mapa
POSICAOYDefine a posição em y da lente em relação ao corpo do mapa
Variaveis
ESTAATIVAIndica se a lente foi ou não aberta
Functions
iniciaAtiva a lente de aumento criando os elementos gráficos necessários e ativando os eventos que controlam a apresentação da lente
atualizaAtualiza a imagem da lente aberta
desativaDesativa alente aberta
movimentaMovimenta a imagem dentro da lente para refletir a posição do mouse
i3GEO. navega. destacaTemaDestaca um tema mostrando-o sobre os outros em um box que segue o mouse
Propriedades
TAMANHOTamanho do box
Functions
iniciaInicia o destaque de um tema
atualizaAtualiza o destaque
desativaDesativa o destaque
movimentaMovimenta o destaque conforme o mouse move
i3GEO. navega. barraDeZoomControla a barra (slide) de zoom
Functions
criaCria os elementos HTML para a barra de zoom
ativaAtiva os botões da barra de zoom
i3GEO. navega. dialogoAbre as telas de diálogo das opções de navegação no mapa atual
Functions
wikiAbre a janela de diálogo da ferramenta wiki permitindo a navegação integrada com a Wikipédia
metarAbre a janela de diálogo da ferramenta metar permitindo a navegação integrada com a rede de dados meteorológicos
buscaFotosAbre a janela de diálogo da ferramenta metar permitindo a navegação integrada com serviços de armazenamento de fotografias
googleAbre a janela de diálogo da ferramenta google permitindo a navegação integrada com o GoogleMaps
confluenceAbre a janela de diálogo da ferramenta confluence permitindo a navegação integrada com a localização de confluências

i3GEO. navega

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)

Summary
Propriedades
TEMPONAVEGARTempo em milisegundos que será esperado para executar uma operação de navegação sobre o mapa.
FATORZOOMValor utilizado nas operações de zoom in e out.
Variaveis
timerNavegaObjeto do tipo timer utilizado no contador de tempo para o delay de execução das funções de navegação
Functions
zoominAproxima o mapa aplicando um fator de modificação da escala
zoomoutAfasta o mapa aplicando um fator de modificação da escala
zoompontoCentraliza o mapa em um ponto e acrescenta o ponto como uma nova camada no mapa
zoompontoIMGCentraliza o mapa em um ponto de coordenadas medidas na imagem do mapa
xy2xyDesloca o mapa de um ponto de coordenadas xy para um segundo ponto
localizaIPLocaliza as coordenadas baseadas no número IP do usuário.
zoomIPMostra no mapa um ponto baseado na localização do usuário.
zoomExtAplica uma nova extensão geográfica ao mapa.
aplicaEscalaAplica ao mapa um novo valor de escala tendo como base o valor do denminador
panFixoDesloca o mapa para uma determinada direção com uma distância fixa.
panFixoNorteDesloca o mapa para o norte
panFixoSulDesloca o mapa para o sul
panFixoOesteDesloca o mapa para o oeste
panFixoLesteDesloca o mapa para o leste
mostraRosaDosVentosMostra sobre o mapa a rosa dos ventos.

Propriedades

TEMPONAVEGAR

Tempo em milisegundos que será esperado para executar uma operação de navegação sobre o mapa.

Controla o lapso de tempo utilizado para disparar as funções do tipo navegação

Tipo

{Numeric}

Default

{1500}

FATORZOOM

Valor utilizado nas operações de zoom in e out.  Fator de zoom.

Default

{2}

Tipo

{Numeric}

Variaveis

timerNavega

Objeto do tipo timer utilizado no contador de tempo para o delay de execução das funções de navegação

Functions

zoomin

zoomin: function(locaplic,
sid)

Aproxima o mapa aplicando um fator de modificação da escala

Parametros

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

zoomout

zoomout: function(locaplic,
sid)

Afasta o mapa aplicando um fator de modificação da escala

Parametros

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

zoomponto

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

Parametros

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

zoompontoIMG: function(locaplic,
sid,
x,
y)

Centraliza o mapa em um ponto de coordenadas medidas na imagem do mapa

Parametros

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

xy2xy: function(locaplic,
sid,
xi,
yi,
xf,
yf,
ext,
tipoimagem)

Desloca o mapa de um ponto de coordenadas xy para um segundo ponto

Parametros

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

localizaIP: function(locaplic,
sid,
funcao)

Localiza as coordenadas baseadas no número IP do usuário.

Parametros

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.

zoomIP

zoomIP: function(locaplic,
sid)

Mostra no mapa um ponto baseado na localização do usuário.

Parametros

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

zoomExt

zoomExt: function(locaplic,
sid,
tipoimagem,
ext)

Aplica uma nova extensão geográfica ao mapa.

Parametros

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

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.

Parametros

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

panFixo: function(locaplic,
sid,
direcao,
w,
h,
escala)

Desloca o mapa para uma determinada direção com uma distância fixa.

Parametros

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

panFixoNorte

panFixoNorte: function()

Desloca o mapa para o norte

panFixoSul

panFixoSul: function()

Desloca o mapa para o sul

panFixoOeste

panFixoOeste: function()

Desloca o mapa para o oeste

panFixoLeste

panFixoLeste: function()

Desloca o mapa para o leste

mostraRosaDosVentos

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

i3GEO. navega. autoRedesenho

Controla o redesenho automático do mapa por meio de um temporizador

Summary
Propriedades
INTERVALOIntervalo de tempo, em milisegundos, que será utilizado para disparar o desenho do mapa
Variaveis
IDGuarda o valor do ID do elemento HTML que receberá o contador de tempo
Functions
ativaAtiva o auto-redesenho do mapa
desativaDesativa o auto-redesenho do mapa
redesenhaRedesenha o mapa quando o contador de tempo chegar a zero
contagemFaz a contagem do tempo

Propriedades

INTERVALO

Intervalo de tempo, em milisegundos, que será utilizado para disparar o desenho do mapa

Tipo

{Integer}

Default

{0}

Variaveis

ID

Guarda o valor do ID do elemento HTML que receberá o contador de tempo

Tipo

{String}

Functions

ativa

ativa: function(id)

Ativa o auto-redesenho do mapa

Parametros

id {String}id do elemento onde o contador de tempo será mostrado no mapa.  Por default, utiliza “tempoRedesenho”.

desativa

desativa:function()

Desativa o auto-redesenho do mapa

redesenha

redesenha: function()

Redesenha o mapa quando o contador de tempo chegar a zero

contagem

contagem: function()

Faz a contagem do tempo

i3GEO. navega. zoomBox

Controla o desenho de um box na tela para executar o zoom por box

Summary
Functions
iniciaMarca o início do desenho do box, capturando a posição do mouse
criaBoxCria o DIV que será utilizado para desenhar o box no mapa
deslocaDesloca o box conforme o mouse é movimentado
terminaPara o desenho do box, captura seu tamanho e faz o zoom no mapa

Functions

inicia

inicia: function()

Marca o início do desenho do box, capturando a posição do mouse

criaBox

criaBox: function()

Cria o DIV que será utilizado para desenhar o box no mapa

desloca

desloca: function()

Desloca o box conforme o mouse é movimentado

termina

termina: function()

Para o desenho do box, captura seu tamanho e faz o zoom no mapa

i3GEO. navega. entorno

Controla o desenho do entorno do mapa (modo tile)

Summary
Functions
ativaDesativaAjusta o mapa para ativar ou desativar o desenho do entorno
geraURLGera as URLs que serão utilizadas na tag IMG dos elementos do entorno do mapa
ajustaPosicaoAjusta a posição das imagens do entorno do mapa

Functions

ativaDesativa

ativaDesativa: function()

Ajusta o mapa para ativar ou desativar o desenho do entorno

Ao ser chamada, essa função muda o modo atual, ativando ou desativando o entorno

geraURL

geraURL: function()

Gera as URLs que serão utilizadas na tag IMG dos elementos do entorno do mapa

ajustaPosicao

ajustaPosicao: function()

Ajusta a posição das imagens do entorno do mapa

i3GEO. navega. lente

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

Summary
Propriedades
POSICAOXDefine a posição em x da lente em relação ao corpo do mapa
POSICAOYDefine a posição em y da lente em relação ao corpo do mapa
Variaveis
ESTAATIVAIndica se a lente foi ou não aberta
Functions
iniciaAtiva a lente de aumento criando os elementos gráficos necessários e ativando os eventos que controlam a apresentação da lente
atualizaAtualiza a imagem da lente aberta
desativaDesativa alente aberta
movimentaMovimenta a imagem dentro da lente para refletir a posição do mouse

Propriedades

POSICAOX

Define a posição em x da lente em relação ao corpo do mapa

Tipo

{numeric}

Default

{0}

POSICAOY

Define a posição em y da lente em relação ao corpo do mapa

Tipo

{numeric}

Default

{0}

Variaveis

ESTAATIVA

Indica se a lente foi ou não aberta

Functions

inicia

inicia: function()

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: function()

Atualiza a imagem da lente aberta

desativa

desativa: function()

Desativa alente aberta

movimenta

movimenta: function()

Movimenta a imagem dentro da lente para refletir a posição do mouse

i3GEO. navega. destacaTema

Destaca um tema mostrando-o sobre os outros em um box que segue o mouse

Summary
Propriedades
TAMANHOTamanho do box
Functions
iniciaInicia o destaque de um tema
atualizaAtualiza o destaque
desativaDesativa o destaque
movimentaMovimenta o destaque conforme o mouse move

Propriedades

TAMANHO

Tamanho do box

Tipo

{Integer}

Default

{75}

Functions

inicia

inicia: function(tema)

Inicia o destaque de um tema

Parametros

tema {String}código do tema

atualiza

atualiza: function()

Atualiza o destaque

É definido para o evento de navegação do mapa

desativa

desativa: function()

Desativa o destaque

movimenta

movimenta: function()

Movimenta o destaque conforme o mouse move

É definido para o evento de deslocamento do mouse

i3GEO. navega. barraDeZoom

Controla a barra (slide) de zoom

Summary
Functions
criaCria os elementos HTML para a barra de zoom
ativaAtiva os botões da barra de zoom

Functions

cria

cria: function()

Cria os elementos HTML para a barra de zoom

Return

{string}código html

ativa

ativa: function()

Ativa os botões da barra de zoom

i3GEO. navega. dialogo

Abre as telas de diálogo das opções de navegação no mapa atual

Summary
Functions
wikiAbre a janela de diálogo da ferramenta wiki permitindo a navegação integrada com a Wikipédia
metarAbre a janela de diálogo da ferramenta metar permitindo a navegação integrada com a rede de dados meteorológicos
buscaFotosAbre a janela de diálogo da ferramenta metar permitindo a navegação integrada com serviços de armazenamento de fotografias
googleAbre a janela de diálogo da ferramenta google permitindo a navegação integrada com o GoogleMaps
confluenceAbre a janela de diálogo da ferramenta confluence permitindo a navegação integrada com a localização de confluências

Functions

wiki

wiki: function()

Abre a janela de diálogo da ferramenta wiki permitindo a navegação integrada com a Wikipédia

metar

metar: function()

Abre a janela de diálogo da ferramenta metar permitindo a navegação integrada com a rede de dados meteorológicos

buscaFotos

buscaFotos: function()

Abre a janela de diálogo da ferramenta metar permitindo a navegação integrada com serviços de armazenamento de fotografias

google

google: function(coordenadas)

Abre a janela de diálogo da ferramenta google permitindo a navegação integrada com o GoogleMaps

Parametros

coordenadas {array}array com os pares de coordenadas x,y que serão adicionados ao mapa do google (opcional)

confluence

confluence: function()

Abre a janela de diálogo da ferramenta confluence permitindo a navegação integrada com a localização de confluências

zoomin: function(locaplic,
sid)
Aproxima o mapa aplicando um fator de modificação da escala
zoomout: function(locaplic,
sid)
Afasta o mapa aplicando um fator de modificação da escala
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
zoompontoIMG: function(locaplic,
sid,
x,
y)
Centraliza o mapa em um ponto de coordenadas medidas na imagem do mapa
xy2xy: function(locaplic,
sid,
xi,
yi,
xf,
yf,
ext,
tipoimagem)
Desloca o mapa de um ponto de coordenadas xy para um segundo ponto
localizaIP: function(locaplic,
sid,
funcao)
Localiza as coordenadas baseadas no número IP do usuário.
zoomIP: function(locaplic,
sid)
Mostra no mapa um ponto baseado na localização do usuário.
zoomExt: function(locaplic,
sid,
tipoimagem,
ext)
Aplica uma nova extensão geográfica ao mapa.
aplicaEscala: function(locaplic,
sid,
escala)
Aplica ao mapa um novo valor de escala tendo como base o valor do denminador
panFixo: function(locaplic,
sid,
direcao,
w,
h,
escala)
Desloca o mapa para uma determinada direção com uma distância fixa.
panFixoNorte: function()
Desloca o mapa para o norte
panFixoSul: function()
Desloca o mapa para o sul
panFixoOeste: function()
Desloca o mapa para o oeste
panFixoLeste: function()
Desloca o mapa para o leste
mostraRosaDosVentos: function()
Mostra sobre o mapa a rosa dos ventos.
ativa: function(id)
Ativa o auto-redesenho do mapa
desativa:function()
Desativa o auto-redesenho do mapa
redesenha: function()
Redesenha o mapa quando o contador de tempo chegar a zero
contagem: function()
Faz a contagem do tempo
inicia: function()
Marca o início do desenho do box, capturando a posição do mouse
criaBox: function()
Cria o DIV que será utilizado para desenhar o box no mapa
desloca: function()
Desloca o box conforme o mouse é movimentado
termina: function()
Para o desenho do box, captura seu tamanho e faz o zoom no mapa
ativaDesativa: function()
Ajusta o mapa para ativar ou desativar o desenho do entorno
geraURL: function()
Gera as URLs que serão utilizadas na tag IMG dos elementos do entorno do mapa
ajustaPosicao: function()
Ajusta a posição das imagens do entorno do mapa
inicia: function()
Ativa a lente de aumento criando os elementos gráficos necessários e ativando os eventos que controlam a apresentação da lente
atualiza: function()
Atualiza a imagem da lente aberta
desativa: function()
Desativa alente aberta
movimenta: function()
Movimenta a imagem dentro da lente para refletir a posição do mouse
inicia: function(tema)
Inicia o destaque de um tema
atualiza: function()
Atualiza o destaque
desativa: function()
Desativa o destaque
movimenta: function()
Movimenta o destaque conforme o mouse move
cria: function()
Cria os elementos HTML para a barra de zoom
ativa: function()
Ativa os botões da barra de zoom
wiki: function()
Abre a janela de diálogo da ferramenta wiki permitindo a navegação integrada com a Wikipédia
metar: function()
Abre a janela de diálogo da ferramenta metar permitindo a navegação integrada com a rede de dados meteorológicos
buscaFotos: function()
Abre a janela de diálogo da ferramenta metar permitindo a navegação integrada com serviços de armazenamento de fotografias
google: function(coordenadas)
Abre a janela de diálogo da ferramenta google permitindo a navegação integrada com o GoogleMaps
confluence: function()
Abre a janela de diálogo da ferramenta confluence permitindo a navegação integrada com a localização de confluências