Interface

Funcoes que controlam o comportamento específico de determinadas interfaces

As interfaces são definidas na inicialização do i3Geo, por exemplo, openlayers,etc

A classe “interface” contém os métdos específicos utilizados nessas interfaces

Namespace

i3GEO.Interface

Exemplo

Para iniciar o i3geo com uma interface específica, utilize http://localhost/i3geo/ms_criamapa.php?interface=black_gm.phtml

O HTML deve conter as definições da interface criada e deve estar armazenado em i3geo/aplicmap

Veja

http://localhost/i3geo/classesjs/classe_interface.js

Summary

Interface	Funcoes que controlam o comportamento específico de determinadas interfaces
Propriedades
TABLET	Quando true, são aplicadas configurações especiais para uso em tablets.
ALTTABLET	Nome do arquivo HTML com a interface alternativa utilizada quando o i3Geo detecta o uso de um dispositivo móvel
BARRABOTOESTOP	Distancia da barra de botões em relação ao topo do mapa.
BARRABOTOESLEFT	Distancia da barra de botões em relação ao lado esquerdo do mapa.
BARRADEZOOMRIGHT	Distancia da barra de botões em relação ao lado direito do mapa.
BARRADEZOOMTOP	Distancia da barra de zoom em relação ao topo do mapa.
BARRADEZOOMLEFT	Distancia da barra de zoom em relação ao lado esquerdo do mapa.
ATUAL	Interface utilizada na criação e controle do mapa.
IDCORPO	ID do elemento HTML que receberá o corpo do mapa
Variaveis
IDMAPA	ID do elemento HTML criado para conter o mapa
Functions
redesenha	Aplica o método redesenha da interface atual.
aplicaOpacidade	Aplica um fator de opacidade a todos os layers do mapa
atualizaMapa	Aplica o método atualizaMapa da interface atual.
atualizaTema	Aplica o método atualizaTema da interface atual
ligaDesliga	Liga/desliga um tema
adicionaKml	Aplica o método de adição de kml ao mapa conforme a interface atual
alteraLayers	Altera todos os layers do mapa modificando um determinado parametro
i3GEO.Interface.OpenLayers	Interface com motor de navegação baseado na API OpenLayers
Propriedades
parametrosMap	Permite incluir parametros da API do OpenLayers nao previstos no i3Geo
parametrosView	Permite incluir parametros da API do OpenLayers nao previstos no i3Geo
interacoes	Interacoes utilizadas no mapa.
FUNDOTEMA	Estilo “background” do nome do tema na árvore de camadas enquanto o mesmo está sendo carregado.
TILES	Indica se por default será utilizado o modo de navegação em tiles em todas as camadas do mapa
GADGETS	Lista dos controles específicos da API do OpenLayers que serão inseridos ou não no mapa
SCALELINE	Propriedades da API do OL3 para o controle de barra de escala
ZOOM	Propriedades da API do OL3 para o controle de zoom
ZOOMSLIDER	Propriedades da API do OL3 para o controle de zoomBar
MINEXTENT	Menor extensão geográfica que pode ser mostrada no mapa
MAXEXTENT	Maior extensão geográfica que pode ser mostrada no mapa
LAYERSADICIONAIS	Objetos do tipo LAYER que serão adicionados após a crioação de todos os layers default.
LAYERFUNDO	Nome do layer do tipo baselayer que sera ativado
googleLike	Indica se a projeção cartográfica do mapa atual é a mesma utilizada pela API do Google Maps
i3GEO.Interface.Googlemaps	Interface com motor de navegação baseado na API Google Maps
Propriedades
ESTILOS	Estilos que podem ser utilizados com o mapa
ESTILOPADRAO	Nome do estilo definido em ESTILOS que sera usado como padrao para o mapa.
MAPOPTIONS	Objeto contendo opções que serão utilizadas no construtor do mapa conforme a API do GoogleMaps
OPACIDADE	Valor da opacidade das camadas i3geo do mapa
TIPOMAPA	Tipo de mapa que será usado como default, conforme constantes definidas na API do Google Maps.
Variaveis
ZOOMSCALE	Array com a lista de escalas em cada nivel de zoom utilizado pelo Google
Functions
adicionaKml	Insere no mapa uma camada KML com base na API do Google Maps

Propriedades

TABLET

Quando true, são aplicadas configurações especiais para uso em tablets.

Altera o posicionamento da barra de botões e comportamento das guias. Veja o exemplo interface/openlayers_t.htm.

Tipo

{boolean}

Default

false

ALTTABLET

Nome do arquivo HTML com a interface alternativa utilizada quando o i3Geo detecta o uso de um dispositivo móvel

A detecção é aplicada automaticamente quando essa variável for definida

Para não aplicar a detecção, use i3GEO.Interface.ALTTABLET = “”

Tipo

{string}

BARRABOTOESTOP

Distancia da barra de botões em relação ao topo do mapa.

Tipo

{number}

Default

BARRABOTOESLEFT

Distancia da barra de botões em relação ao lado esquerdo do mapa.

Tipo

{number}

Default

BARRADEZOOMRIGHT

Distancia da barra de botões em relação ao lado direito do mapa.

Utilizado para ajustar a barra de zoom

Tipo

{number}

Default

BARRADEZOOMTOP

Distancia da barra de zoom em relação ao topo do mapa.

Tipo

{number}

Default

BARRADEZOOMLEFT

Distancia da barra de zoom em relação ao lado esquerdo do mapa.

Tipo

{number}

Default

ATUAL

Interface utilizada na criação e controle do mapa.

Veja como usar nos arquivos de apresentação do mapa existentes no diretório i3geo/interface

O i3Geo, além da interface própria, permite o uso de outras APIs para a construção do mapa, como Google Maps ou Openlayers. Essa propriedade define qual interface será usada. Não confundir com o nome do HTML que é utilizado para mostrar o mapa.

Para definir a interface, utilize

i3GEO.Interface.ATUAL = “<valor>”

Tipo

{string}

Valores

openlayers|googlemaps

Default

openlayers

IDCORPO

ID do elemento HTML que receberá o corpo do mapa

Tipo

{string}

Default

corpoMapa

Variaveis

IDMAPA

ID do elemento HTML criado para conter o mapa

Esse elemento normalmente é criado dentro de IDCORPO dependendo da interface

Functions

redesenha

redesenha : function()

Aplica o método redesenha da interface atual. Em alguns casos, a função de redesenho aplica os mesmos processos da função de atualizar o mapa. Isso ocorre pq em alguns casos as funções são otimizadas para cada situação

aplicaOpacidade

aplicaOpacidade : function( opacidade,
layer )

Aplica um fator de opacidade a todos os layers do mapa

Parametro

{numerico}	0 a 1
{string}	(opcional) se for vazio aplica ao mapa todo

atualizaMapa

atualizaMapa : function()

Aplica o método atualizaMapa da interface atual. Em alguns casos, a função de redesenho aplica os mesmos processos da função de atualizar o mapa. Isso ocorre pq em alguns casos as funções são otimizadas para cada situação

atualizaTema

atualizaTema : function( retorno,
tema )

Aplica o método atualizaTema da interface atual

Parametros

{Objeto} -parametros obtidos da função PHP de redesenho do mapa. Quando igual a “”, é feita apenas a atualização da camada, sem que a árvore de camadas seja atualizada.

{string}

código do tema

ligaDesliga

ligaDesliga : function( obj )

Liga/desliga um tema

Parametros

{object}

objeto do tipo checkbox que foi acionado na arvore de camadas ou objeto que contenha as propriedades value e checked, sendo value o código do layer

adicionaKml

adicionaKml : function()

Aplica o método de adição de kml ao mapa conforme a interface atual

alteraLayers

Altera todos os layers do mapa modificando um determinado parametro

Parametros

{string}	nome do parâmetro
{string}	valor a ser atribuído

i3GEO.Interface.OpenLayers

Interface com motor de navegação baseado na API OpenLayers

Namespace

i3GEO.Interface.openlayers

Utilizado quando

i3GEO.Interface.ATUAL = “openlayers”

Cria o objeto i3geoOL que pode receber os métodos da API do OpenLayers

Summary

Propriedades
parametrosMap	Permite incluir parametros da API do OpenLayers nao previstos no i3Geo
parametrosView	Permite incluir parametros da API do OpenLayers nao previstos no i3Geo
interacoes	Interacoes utilizadas no mapa.
FUNDOTEMA	Estilo “background” do nome do tema na árvore de camadas enquanto o mesmo está sendo carregado.
TILES	Indica se por default será utilizado o modo de navegação em tiles em todas as camadas do mapa
GADGETS	Lista dos controles específicos da API do OpenLayers que serão inseridos ou não no mapa
SCALELINE	Propriedades da API do OL3 para o controle de barra de escala
ZOOM	Propriedades da API do OL3 para o controle de zoom
ZOOMSLIDER	Propriedades da API do OL3 para o controle de zoomBar
MINEXTENT	Menor extensão geográfica que pode ser mostrada no mapa
MAXEXTENT	Maior extensão geográfica que pode ser mostrada no mapa
LAYERSADICIONAIS	Objetos do tipo LAYER que serão adicionados após a crioação de todos os layers default.
LAYERFUNDO	Nome do layer do tipo baselayer que sera ativado
googleLike	Indica se a projeção cartográfica do mapa atual é a mesma utilizada pela API do Google Maps

Propriedades

parametrosMap

Permite incluir parametros da API do OpenLayers nao previstos no i3Geo

Parametros do objeto map do OpenLayers

parametrosView

Permite incluir parametros da API do OpenLayers nao previstos no i3Geo

Parametros do objeto View do OpenLayers

interacoes

Interacoes utilizadas no mapa.

http://openlayers.org/en/v3.4.0/apidoc/ol.interaction.Interaction.html?unstable=true

Parametros do objeto Map.options.interactions do OpenLayers

Se for um array vazio, as interacoes default sao adicionadas na funcao de i3GEO.Interface.openlayers.cria

Tipo

{array}

FUNDOTEMA

Estilo “background” do nome do tema na árvore de camadas enquanto o mesmo está sendo carregado.

Permite destacar o nome do tema que está em processo de carregamento

Tipo

{string}

Default

yellow

TILES

Indica se por default será utilizado o modo de navegação em tiles em todas as camadas do mapa

Ao bloquear o modo tile, o cache de imagens não poderá ser realizado

A configuração de cada camada sobrepõe essa propriedade

Tipo

{boolean}

Default

true

GADGETS

Lista dos controles específicos da API do OpenLayers que serão inseridos ou não no mapa

Tipo

{object}

Default

{ZoomSlider:true,Zoom: false,LayerSwitcher:true,ScaleLine:true,OverviewMap:false}

SCALELINE

Propriedades da API do OL3 para o controle de barra de escala

http://openlayers.org/en/v3.4.0/apidoc/ol.control.ScaleLine.html

Tipo

{object}

Default: {}

ZOOM

Propriedades da API do OL3 para o controle de zoom

http://openlayers.org/en/v3.4.0/apidoc/ol.control.Zoom.html

Tipo

{object}

Default: {}

ZOOMSLIDER

Propriedades da API do OL3 para o controle de zoomBar

http://openlayers.org/en/v3.4.0/apidoc/ol.control.ZoomSlider.html

Tipo

{object}

Default: {}

MINEXTENT

Menor extensão geográfica que pode ser mostrada no mapa

Tipo

{array}

Default

[-0.0003, -0.0003, 0.0003, 0.0003]

MAXEXTENT

Maior extensão geográfica que pode ser mostrada no mapa

Tipo

{array}

Default

[-180, -90, 180, 90]

LAYERSADICIONAIS

Objetos do tipo LAYER que serão adicionados após a crioação de todos os layers default.

Tipo

{array}

LAYERFUNDO

Nome do layer do tipo baselayer que sera ativado

googleLike

Indica se a projeção cartográfica do mapa atual é a mesma utilizada pela API do Google Maps

Tipo

{boolean}

Default

false

i3GEO.Interface.Googlemaps

Interface com motor de navegação baseado na API Google Maps

Namespace

i3GEO.Interface.googlemaps

Utilizado quando

i3GEO.Interface.ATUAL = “googlemaps”

Cria o objeto i3GeoMap que pode receber os métodos da API. Cria também o objeto i3GeoMapOverlay do tipo Overlay, utilizado para cálculos ou para receber elementos gráficos.

Summary

Propriedades
ESTILOS	Estilos que podem ser utilizados com o mapa
ESTILOPADRAO	Nome do estilo definido em ESTILOS que sera usado como padrao para o mapa.
MAPOPTIONS	Objeto contendo opções que serão utilizadas no construtor do mapa conforme a API do GoogleMaps
OPACIDADE	Valor da opacidade das camadas i3geo do mapa
TIPOMAPA	Tipo de mapa que será usado como default, conforme constantes definidas na API do Google Maps.
Variaveis
ZOOMSCALE	Array com a lista de escalas em cada nivel de zoom utilizado pelo Google
Functions
adicionaKml	Insere no mapa uma camada KML com base na API do Google Maps

Propriedades

ESTILOS

Estilos que podem ser utilizados com o mapa

Para novos estilos, acrescente seu codigo nesse objeto

Fonte http://maps-api-tt.appspot.com/apilite/styled/styled.html

Tipo

{objeto}

ESTILOPADRAO

Nome do estilo definido em ESTILOS que sera usado como padrao para o mapa. Se for “” sera usado o estilo normal do Google

Estilos pre-definidos Red, Countries, Night, Blue, Greyscale, No roads, Mixed, Chilled

Tipo

{string}

MAPOPTIONS

Objeto contendo opções que serão utilizadas no construtor do mapa conforme a API do GoogleMaps

Exemplo de uso

i3GEO.Interface.googlemaps.MAPOPTIONS = {maxZoom:5};

https://developers.google.com/maps/documentation/javascript/reference#MapOptions

Tipo

{MapOptions}

OPACIDADE

Valor da opacidade das camadas i3geo do mapa

Varia de 0 a 1

Tipo

{Numeric}

Default: 0.8

TIPOMAPA

Tipo de mapa que será usado como default, conforme constantes definidas na API do Google Maps.

Tipo

{string}

Valores

satellite|roadmap|hybrid|terrain

Default

terrain

Variaveis

ZOOMSCALE

Array com a lista de escalas em cada nivel de zoom utilizado pelo Google

Tipo

{array}

Functions

adicionaKml

adicionaKml : function( pan,
url,
titulo,
ativo )

Insere no mapa uma camada KML com base na API do Google Maps

As camadas adicionadas são acrescentadas na árvore de camadas

A lista de nomes dos objetos geoXml criados é mantida em i3GEO.mapas.GEOXML

Parametros

{Boolean}	define se o mapa será deslocado para encaixar o KML
{String}	URL do arquivo KML. Se não for definido, a URL será obtida do INPUT com id = i3geo_urlkml (veja i3GEO.gadgets.mostraInserirKml)
{string}	titulo que aparecerá na árvore. Se não for definido, será calculado aleatoriamente.
{boolean}	indica se a camada estará ativa ou não. Se não for definido, será considerado como true