OSGeo - User contributions [en]

OpenLayers Tutorial Pt

2008-10-13T22:03:57Z

Wiki-Nsosilva:

Web Feature Service

2008-10-01T21:09:42Z

Wiki-Nsosilva:

O serviço de entidades geográficas padrão do ''OpenGIS'' WFS define uma [http://www.opengeospatial.org/ogc/glossary/i interface] para especificar os pedidos de [http://www.opengeospatial.org/ogc/glossary/g recursos geográficos] através de toda a Web utilizando chamadas independente de plataforma. O padrão de WFS define interfaces e operações para a manipulação e acesso de dados para um conjunto de características geográficas, incluindo:
* ''getCapabilities'': descrição das características do recurso ou servidor;
* ''describeFeatureType'': descrição dos tipos que caracterizam as entidades que podem ser servidas;
* ''getFeature'': devolve as instâncias dos objectos disponíveis;
* ''transaction'': executa operações de modificação dos objectos (inserção, remoção e actualização);
* ''lockFeature'': bloqueia uma ou mais instâncias durante uma transacção.

== Ver Também ==
Ver no [[OpenLayers Tutorial Pt|tutorial do OpenLayers em português]] mais informações.

Web Map Service

2008-10-01T21:09:32Z

Wiki-Nsosilva:

O serviço de mapas ''OpenGIS'' Web Map Service (WMS) fornece uma interface simples para pedidos de imagens (mapa) via ''HTTP''. Estas imagens (mapas), estão numa ou mais base de dados geoespaciais distribuídas. Um pedido WMS define a(s) camada(s) geográfica(s) e a área de interesse, cuja resposta ao pedido consiste numa ou mais imagens de um mapa (no formato JPEG, PNG, etc.), as quais podem ser visualizadas num navegador Web. A interface também oferece suporte à capacidade para especificar se as imagens em causa devem ser transparentes para poder combinar diversas camadas.

== Ver Também ==

Ver no [[OpenLayers Tutorial Pt|tutorial do OpenLayers em português]] mais informações.

Web Feature Service

2008-10-01T21:09:19Z

Wiki-Nsosilva:

O serviço de entidades geográficas padrão do ''OpenGIS'' WFS define uma [http://www.opengeospatial.org/ogc/glossary/i interface] para especificar os pedidos de [http://www.opengeospatial.org/ogc/glossary/g recursos geográficos] através de toda a Web utilizando chamadas independente de plataforma. O padrão de WFS define interfaces e operações para a manipulação e acesso de dados para um conjunto de características geográficas, incluindo:
* ''getCapabilities'': descrição das características do recurso ou servidor;
* ''describeFeatureType'': descrição dos tipos que caracterizam as entidades que podem ser servidas;
* ''getFeature'': devolve as instâncias dos objectos disponíveis;
* ''transaction'': executa operações de modificação dos objectos (inserção, remoção e actualização);
* ''lockFeature'': bloqueia uma ou mais instâncias durante uma transacção.

== Ver ==
Ver no [[OpenLayers Tutorial Pt|tutorial do OpenLayers em português]] mais informações.

Web Map Service

2008-10-01T21:09:10Z

Wiki-Nsosilva:

O serviço de mapas ''OpenGIS'' Web Map Service (WMS) fornece uma interface simples para pedidos de imagens (mapa) via ''HTTP''. Estas imagens (mapas), estão numa ou mais base de dados geoespaciais distribuídas. Um pedido WMS define a(s) camada(s) geográfica(s) e a área de interesse, cuja resposta ao pedido consiste numa ou mais imagens de um mapa (no formato JPEG, PNG, etc.), as quais podem ser visualizadas num navegador Web. A interface também oferece suporte à capacidade para especificar se as imagens em causa devem ser transparentes para poder combinar diversas camadas.

== Ver ==

Ver no [[OpenLayers Tutorial Pt|tutorial do OpenLayers em português]] mais informações.

OpenLayers Tutorial Pt

2008-10-01T21:07:03Z

Wiki-Nsosilva: /* Fornecedores de Serviços */

OpenLayers Tutorial Pt

2008-10-01T20:54:13Z

Wiki-Nsosilva: /* Outros Recursos */

OpenLayers Tutorial Pt

2008-10-01T20:51:38Z

Wiki-Nsosilva: /* Para Programadores */

OpenLayers Tutorial Pt

2008-10-01T20:51:10Z

Wiki-Nsosilva: /* "Olá Mundo" OpenLayers */

OpenLayers Tutorial Pt

2008-10-01T20:50:59Z

Wiki-Nsosilva: /* Exemplos simples, passo a passo */

OpenLayers Tutorial Pt

2008-10-01T20:50:35Z

Wiki-Nsosilva: /* "Olá Mundo" OpenLayers */

OpenLayers Tutorial Pt

2008-10-01T20:50:18Z

Wiki-Nsosilva: /* Exemplos simples, passo a passo */

OpenLayers pt

2008-10-01T20:49:04Z

Wiki-Nsosilva: /* Para Programadores */

== Sobre o OpenLayers ==

[http://openlayers.org/ OpenLayers] facilita a inclusão dinâmica de um mapa em qualquer página Web. Este pode ser carregado de qualquer fonte, assim como os recursos para sobrepor no mapa. Estes recursos podem ser, por exemplo, o nome dos países, hospitais, restaurantes, estradas, etc.
A primeira versão do ''OpenLayers'' foi desenvolvida pela [http://www.metacarta.com/ MetaCarta], que posteriormente a cedeu ao público para futura utilização em todo o tipo de sistemas de informação geográfica.
''OpenLayers'' é completamente livre e de código aberto (''JavaScript''), lançado sob a licença '''BSD'''.

== Ver ==

Ver no [[OpenLayers Tutorial Pt|tutorial do OpenLayers em português]] mais informações.

OpenLayers Tutorial Pt

2008-09-30T22:50:08Z

Wiki-Nsosilva: /* Exemplos simples, passo a passo */

OpenLayers Tutorial Pt

2008-09-30T22:49:17Z

Wiki-Nsosilva: /* Para Programadores */

OpenLayers Tutorial Pt

2008-09-30T22:48:48Z

Wiki-Nsosilva: /* Funcionalidades Avançadas */

OpenLayers Tutorial Pt

2008-09-30T22:13:57Z

Wiki-Nsosilva: /* Outros Recursos */

OpenLayers Tutorial Pt

2008-09-30T22:10:31Z

Wiki-Nsosilva: /* Fornecedores de Serviços */

OpenLayers Tutorial Pt

2008-09-30T22:05:02Z

Wiki-Nsosilva: /* Fornecedores de Serviços */

OpenLayers Tutorial Pt

2008-09-30T22:02:33Z

Wiki-Nsosilva:

Web Map Service

2008-09-30T21:40:00Z

Wiki-Nsosilva:

Web Map Service

2008-09-30T21:39:37Z

Wiki-Nsosilva: New page: O serviço de mapas ''OpenGIS'' Web Map Service (WMS) fornece uma interface simples para pedidos de imagens (mapa) via ''HTTP''. Estas imagens (mapas), estão numa ou mais bases de dados g...

O serviço de mapas ''OpenGIS'' Web Map Service (WMS) fornece uma interface simples para pedidos de imagens (mapa) via ''HTTP''. Estas imagens (mapas), estão numa ou mais bases de dados geoespaciais distribuídas. Um pedido WMS define a(s) camada(s) geográfica(s) e a área de interesse, cuja resposta ao pedido consiste numa ou mais imagens de um mapa (no formato JPEG, PNG, etc.), as quais podem ser visualizadas num navegador Web. A interface também oferece suporte à capacidade para especificar se as imagens em causa devem ser transparentes para poder combinar diversas camadas.

Web Feature Service

2008-09-30T21:32:47Z

Wiki-Nsosilva:

OpenLayers Tutorial Pt

2008-09-30T21:30:00Z

Wiki-Nsosilva: /* Para Programadores */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante para a utilização do ''OpenLayers''.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[Web Map Service]] e [[Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

*TODO:
** descrever um WMS, WFS e indicar WMS e WFS portugueses.
** criar um mapa com os WMS e WFS descritos.

== Outros Recursos ==

* [http://www.igeo.pt/ Instituto Geográfico Português]
* [http://www.igeoe.pt/ Instituto Geográfico do Exército]
* [http://snig.igeo.pt/Portal/ Sistema Nacional de Informação Geográfica]
* [http://scrif.igeo.pt/ Rede de Informação de Situações de Emergência]
* [http://trac.openlayers.org/ OpenLayers]
* [http://udig.refractions.net/ GIS Framework para o Eclipse]

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

Web Feature Service

2008-09-30T21:28:46Z

Wiki-Nsosilva: New page: A interface padrão do ''OpenGIS'' WFS define uma [http://www.opengeospatial.org/ogc/glossary/i interface] para especificar os pedidos de [http://www.opengeospatial.org/ogc/glossary/g recu...

A interface padrão do ''OpenGIS'' WFS define uma [http://www.opengeospatial.org/ogc/glossary/i interface] para especificar os pedidos de [http://www.opengeospatial.org/ogc/glossary/g recursos geográficos] através de toda a Web utilizando chamadas independente de plataforma. O padrão de WFS define interfaces e operações para a manipulação e acesso de dados para um conjunto de características geográficas, incluindo:
* ''getCapabilities'': descrição das características do recurso ou servidor;
* ''describeFeatureType'': descrição dos tipos que caracterizam as entidades que podem ser servidas;
* ''getFeature'': devolve as instâncias dos objectos disponíveis;
* ''transaction'': executa operações de modificação dos objectos (inserção, remoção e actualização);
* ''lockFeature'': bloqueia uma ou mais instâncias durante uma transacção.

OpenLayers Tutorial Pt

2008-09-30T21:28:23Z

Wiki-Nsosilva: /* Para Programadores */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante para a utilização do ''OpenLayers''.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[Web Mapping Service]] e [[Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

*TODO:
** descrever um WMS, WFS e indicar WMS e WFS portugueses.
** criar um mapa com os WMS e WFS descritos.

== Outros Recursos ==

* [http://www.igeo.pt/ Instituto Geográfico Português]
* [http://www.igeoe.pt/ Instituto Geográfico do Exército]
* [http://snig.igeo.pt/Portal/ Sistema Nacional de Informação Geográfica]
* [http://scrif.igeo.pt/ Rede de Informação de Situações de Emergência]
* [http://trac.openlayers.org/ OpenLayers]
* [http://udig.refractions.net/ GIS Framework para o Eclipse]

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-30T21:27:42Z

Wiki-Nsosilva: /* Para Programadores */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante para a utilização do ''OpenLayers''.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[Web Mapping Service)]] e [[Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

*TODO:
** descrever um WMS, WFS e indicar WMS e WFS portugueses.
** criar um mapa com os WMS e WFS descritos.

== Outros Recursos ==

* [http://www.igeo.pt/ Instituto Geográfico Português]
* [http://www.igeoe.pt/ Instituto Geográfico do Exército]
* [http://snig.igeo.pt/Portal/ Sistema Nacional de Informação Geográfica]
* [http://scrif.igeo.pt/ Rede de Informação de Situações de Emergência]
* [http://trac.openlayers.org/ OpenLayers]
* [http://udig.refractions.net/ GIS Framework para o Eclipse]

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T23:09:52Z

Wiki-Nsosilva: /* Fornecedores de Serviços */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante para a utilização do ''OpenLayers''.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

*TODO:
** descrever um WMS, WFS e indicar WMS e WFS portugueses.
** criar um mapa com os WMS e WFS descritos.

== Outros Recursos ==

* [http://www.igeo.pt/ Instituto Geográfico Português]
* [http://www.igeoe.pt/ Instituto Geográfico do Exército]
* [http://snig.igeo.pt/Portal/ Sistema Nacional de Informação Geográfica]
* [http://scrif.igeo.pt/ Rede de Informação de Situações de Emergência]
* [http://trac.openlayers.org/ OpenLayers]
* [http://udig.refractions.net/ GIS Framework para o Eclipse]

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T23:05:48Z

Wiki-Nsosilva: /* Outros Recursos */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante para a utilização do ''OpenLayers''.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==

* [http://www.igeo.pt/ Instituto Geográfico Português]
* [http://www.igeoe.pt/ Instituto Geográfico do Exército]
* [http://snig.igeo.pt/Portal/ Sistema Nacional de Informação Geográfica]
* [http://scrif.igeo.pt/ Rede de Informação de Situações de Emergência]
* [http://trac.openlayers.org/ OpenLayers]
* [http://udig.refractions.net/ GIS Framework para o Eclipse]

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T22:55:38Z

Wiki-Nsosilva: /* Outros Recursos */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante para a utilização do ''OpenLayers''.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==

* [http://www.igeo.pt/ Instituto Geográfico Português]
* [http://scrif.igeo.pt/ Rede de Informação de Situações de Emergência]
* [http://trac.openlayers.org/ OpenLayers]
* [http://udig.refractions.net/ GIS Framework para o Eclipse]

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T22:43:50Z

Wiki-Nsosilva: /* Outros Recursos */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante para a utilização do ''OpenLayers''.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==

* [http://www.igeo.pt/ Instituto Geográfico Português]
* [http://trac.openlayers.org/ OpenLayers]
* [http://udig.refractions.net/ GIS Framework para o Eclipse]

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T22:22:34Z

Wiki-Nsosilva: /* Outros Recursos */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante para a utilização do ''OpenLayers''.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==

* [http://www.igeo.pt/ Instituto Geográfico Português]
* [http://trac.openlayers.org/ OpenLayers]

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T22:17:55Z

Wiki-Nsosilva: /* Exemplos simples, passo a passo */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante para a utilização do ''OpenLayers''.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T22:17:35Z

Wiki-Nsosilva: /* Exemplos simples, passo a passo */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante para a utilização do ''OpenLayers''.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinâmicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T22:16:52Z

Wiki-Nsosilva: /* Exemplos simples, passo a passo */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante para a utilização do ''OpenLayers''.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T22:16:19Z

Wiki-Nsosilva: /* Antes de começar */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante para a utilização do ''OpenLayers''.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

http://openlayers.org/dev/examples/
e
http://trac.openlayers.org/wiki/UserRecipes

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers API

2008-09-29T22:14:42Z

Wiki-Nsosilva: /* Documentação */

==Documentação==
* [http://dev.openlayers.org/releases/OpenLayers-2.6/doc/apidocs/files/OpenLayers-js.html Versão estável da API]
* [http://dev.openlayers.org/apidocs/files/OpenLayers-js.html API da versão em desenvolvimento]

OpenLayers API

2008-09-29T22:12:17Z

Wiki-Nsosilva:

=Documentação=
da versão estável da API pode ser encontrada aqui:
Estável http://dev.openlayers.org/releases/OpenLayers-2.6/doc/apidocs/files/OpenLayers-js.html

A documentação da API (em desenvolvimento), aqui:
http://dev.openlayers.org/apidocs/files/OpenLayers-js.html

OpenLayers API

2008-09-29T22:11:37Z

Wiki-Nsosilva:

A documentação da versão estável da API pode ser encontrada aqui:
Estável http://dev.openlayers.org/releases/OpenLayers-2.6/doc/apidocs/files/OpenLayers-js.html

A documentação da API (em desenvolvimento), aqui:
http://dev.openlayers.org/apidocs/files/OpenLayers-js.html

OpenLayers Tutorial Pt

2008-09-29T22:01:14Z

Wiki-Nsosilva:

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante no processo de aprendizagem.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== Exemplos simples, passo a passo ==

http://openlayers.org/dev/examples/
e
http://trac.openlayers.org/wiki/UserRecipes

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T21:59:25Z

Wiki-Nsosilva: /* "Olá Mundo" OpenLayers */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante no processo de aprendizagem.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como ''Map'' um WMS da MetaCarta.

Para adicionar uma ''Layer'' ao ''Map'', o construtor do ''Layer'' tem como parâmetros a URL do WMS servidor usado, e um objecto que contem os parâmetros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o ponto centra e nível de zoom.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para visualizar o primeiro Mapa.

== Exemplos, passo a passo ==

http://openlayers.org/dev/examples/
e
http://trac.openlayers.org/wiki/UserRecipes

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T21:55:49Z

Wiki-Nsosilva: /* "Olá Mundo" OpenLayers */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante no processo de aprendizagem.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== "Olá Mundo" OpenLayers ==

''Map'' (Mapa) e ''Layer'' (Camada), são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um ''Map'' guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do ''Map'' a informação é disponibilizada via ''Layer's'', que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa ''tag'' deste tipo
incluindo uma ''tag'' ''script'' para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página ''HTML''.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o ''Map'' através do construtor ''OpenLayer.Map'', que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta vários data sources, WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como [[OpenLayers.Map|Map]] um [[OpenLayers.Layer.WMS|WMS]] da MetaCarta.

Para adicionar uma Layer ao Map, o construtor do Layer tem como parametros a URL do WMS server usado, e um objecto que contem os parametros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o center e zoom level.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para vizualizar o primeiro Mapa.

== Exemplos, passo a passo ==

http://openlayers.org/dev/examples/
e
http://trac.openlayers.org/wiki/UserRecipes

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T21:00:35Z

Wiki-Nsosilva:

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante no processo de aprendizagem.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== "Olá Mundo" OpenLayers ==

http://openlayers.org/doc/

[[OpenLayers.Map|Map]] e [[OpenLayers.Map|Layer]] são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um [[OpenLayers.Map|Map]] guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do [[OpenLayers.Map|Map]] a informação é disponibilizada via [[OpenLayers.Layer|Layer]]'s, que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as tags html de tipo block-level.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa tag deste tipo
incluindo uma tag script para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página html.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o [[OpenLayers.Map|Map]] através do construtor [[OpenLayers.Map|OpenLaer.Map]], que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta vários data sources, WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como [[OpenLayers.Map|Map]] um [[OpenLayers.Layer.WMS|WMS]] da MetaCarta.

Para adicionar uma Layer ao Map, o construtor do Layer tem como parametros a URL do WMS server usado, e um objecto que contem os parametros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o center e zoom level.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para vizualizar o primeiro Mapa.

== Exemplos, passo a passo ==

http://openlayers.org/dev/examples/
e
http://trac.openlayers.org/wiki/UserRecipes

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T20:59:52Z

Wiki-Nsosilva: /* Para Programadores */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante no processo de aprendizagem.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre e desenvolvido pela comunidade de software ''Open Source''.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

== "Olá Mundo" OpenLayers ==

http://openlayers.org/doc/

[[OpenLayers.Map|Map]] e [[OpenLayers.Map|Layer]] são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um [[OpenLayers.Map|Map]] guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do [[OpenLayers.Map|Map]] a informação é disponibilizada via [[OpenLayers.Layer|Layer]]'s, que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as tags html de tipo block-level.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa tag deste tipo
incluindo uma tag script para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página html.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o [[OpenLayers.Map|Map]] através do construtor [[OpenLayers.Map|OpenLaer.Map]], que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta vários data sources, WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como [[OpenLayers.Map|Map]] um [[OpenLayers.Layer.WMS|WMS]] da MetaCarta.

Para adicionar uma Layer ao Map, o construtor do Layer tem como parametros a URL do WMS server usado, e um objecto que contem os parametros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o center e zoom level.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para vizualizar o primeiro Mapa.

== Exemplos, passo a passo ==

http://openlayers.org/dev/examples/
e
http://trac.openlayers.org/wiki/UserRecipes

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Before Getting Started -- The Technologies Behind OpenLayers ==

We at !OpenLayers generally ''assume'' that everyone who comes to us is already a highly skilled web programmer. Such, however, is not always the case. Here we have assembled a few quick links to tutorials and the like on how to master the art of coding in !JavaScript, debug in Firebug, understand JSON, etc.

* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introduction to JavaScript] by the people at [http://mootools.net mootools].
* Four-part video series by [http://www.crockford.com/ Douglas Crockford] on [http://video.yahoo.com/watch/111593/1710507 Programming in JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introduction to JSON]
* [http://getfirebug.com/logging.html Debugging with Firebug]

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T20:53:11Z

Wiki-Nsosilva: /* Funcionalidades Avançadas */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante no processo de aprendizagem.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre, desenvolvido pela comunidade de software ''Open Source''.

''OpenLayers'' torna-se um projecto da Fundação de [www.gis.com GIS] de fonte aberta.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

TODO TODO TODO TODO
As a framework, OpenLayers is intended to separate map tools from map data so that all the tools can operate on all the data sources. This separation breaks the proprietary silos that earlier GIS revolutions have taught civilization to avoid. The mapping revolution on the public Web should benefit from the experience of history.

Como ''framework'', ''OpenLayers'' destina-se a separar ferramentas mapa dos dados do mapa, para que todas as ferramentas podem operar em todas as fontes de dados. Esta separação quebra os silos de proprietários que anteriores GIS revoluções ensinaram civilização para evitar. A revolução de mapeamento na Web pública deve beneficiar da experiência da história.

== "Olá Mundo" OpenLayers ==

http://openlayers.org/doc/

[[OpenLayers.Map|Map]] e [[OpenLayers.Map|Layer]] são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um [[OpenLayers.Map|Map]] guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do [[OpenLayers.Map|Map]] a informação é disponibilizada via [[OpenLayers.Layer|Layer]]'s, que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as tags html de tipo block-level.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa tag deste tipo
incluindo uma tag script para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página html.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o [[OpenLayers.Map|Map]] através do construtor [[OpenLayers.Map|OpenLaer.Map]], que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta vários data sources, WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como [[OpenLayers.Map|Map]] um [[OpenLayers.Layer.WMS|WMS]] da MetaCarta.

Para adicionar uma Layer ao Map, o construtor do Layer tem como parametros a URL do WMS server usado, e um objecto que contem os parametros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o center e zoom level.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para vizualizar o primeiro Mapa.

== Exemplos, passo a passo ==

http://openlayers.org/dev/examples/
e
http://trac.openlayers.org/wiki/UserRecipes

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

http://trac.openlayers.org/wiki/GetFeatureInfo

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Before Getting Started -- The Technologies Behind OpenLayers ==

We at !OpenLayers generally ''assume'' that everyone who comes to us is already a highly skilled web programmer. Such, however, is not always the case. Here we have assembled a few quick links to tutorials and the like on how to master the art of coding in !JavaScript, debug in Firebug, understand JSON, etc.

* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introduction to JavaScript] by the people at [http://mootools.net mootools].
* Four-part video series by [http://www.crockford.com/ Douglas Crockford] on [http://video.yahoo.com/watch/111593/1710507 Programming in JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introduction to JSON]
* [http://getfirebug.com/logging.html Debugging with Firebug]

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T20:47:48Z

Wiki-Nsosilva: /* "Olá Mundo" OpenLayers */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante no processo de aprendizagem.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre, desenvolvido pela comunidade de software ''Open Source''.

''OpenLayers'' torna-se um projecto da Fundação de [www.gis.com GIS] de fonte aberta.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

TODO TODO TODO TODO
As a framework, OpenLayers is intended to separate map tools from map data so that all the tools can operate on all the data sources. This separation breaks the proprietary silos that earlier GIS revolutions have taught civilization to avoid. The mapping revolution on the public Web should benefit from the experience of history.

Como ''framework'', ''OpenLayers'' destina-se a separar ferramentas mapa dos dados do mapa, para que todas as ferramentas podem operar em todas as fontes de dados. Esta separação quebra os silos de proprietários que anteriores GIS revoluções ensinaram civilização para evitar. A revolução de mapeamento na Web pública deve beneficiar da experiência da história.

== "Olá Mundo" OpenLayers ==

http://openlayers.org/doc/

[[OpenLayers.Map|Map]] e [[OpenLayers.Map|Layer]] são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um [[OpenLayers.Map|Map]] guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do [[OpenLayers.Map|Map]] a informação é disponibilizada via [[OpenLayers.Layer|Layer]]'s, que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as tags html de tipo block-level.

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa tag deste tipo
incluindo uma tag script para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página html.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o [[OpenLayers.Map|Map]] através do construtor [[OpenLayers.Map|OpenLaer.Map]], que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta vários data sources, WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como [[OpenLayers.Map|Map]] um [[OpenLayers.Layer.WMS|WMS]] da MetaCarta.

Para adicionar uma Layer ao Map, o construtor do Layer tem como parametros a URL do WMS server usado, e um objecto que contem os parametros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o center e zoom level.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para vizualizar o primeiro Mapa.

== Exemplos, passo a passo ==

http://openlayers.org/dev/examples/
e
http://trac.openlayers.org/wiki/UserRecipes

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Before Getting Started -- The Technologies Behind OpenLayers ==

We at !OpenLayers generally ''assume'' that everyone who comes to us is already a highly skilled web programmer. Such, however, is not always the case. Here we have assembled a few quick links to tutorials and the like on how to master the art of coding in !JavaScript, debug in Firebug, understand JSON, etc.

* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introduction to JavaScript] by the people at [http://mootools.net mootools].
* Four-part video series by [http://www.crockford.com/ Douglas Crockford] on [http://video.yahoo.com/watch/111593/1710507 Programming in JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introduction to JSON]
* [http://getfirebug.com/logging.html Debugging with Firebug]

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-29T20:01:59Z

Wiki-Nsosilva: /* Introdução */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [http://www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante no processo de aprendizagem.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre, desenvolvido pela comunidade de software ''Open Source''.

''OpenLayers'' torna-se um projecto da Fundação de [www.gis.com GIS] de fonte aberta.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

TODO TODO TODO TODO
As a framework, OpenLayers is intended to separate map tools from map data so that all the tools can operate on all the data sources. This separation breaks the proprietary silos that earlier GIS revolutions have taught civilization to avoid. The mapping revolution on the public Web should benefit from the experience of history.

Como ''framework'', ''OpenLayers'' destina-se a separar ferramentas mapa dos dados do mapa, para que todas as ferramentas podem operar em todas as fontes de dados. Esta separação quebra os silos de proprietários que anteriores GIS revoluções ensinaram civilização para evitar. A revolução de mapeamento na Web pública deve beneficiar da experiência da história.

== "Olá Mundo" OpenLayers ==

http://openlayers.org/doc/

[[OpenLayers.Map|Map]] e [[OpenLayers.Map|Layer]] são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um [[OpenLayers.Map|Map]] guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do [[OpenLayers.Map|Map]] a informação é disponibilizada via [[OpenLayers.Layer|Layer]]'s, que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as tags html de tipo block-level, (como por exemplo TODO)

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa tag deste tipo
incluindo uma tag script para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página html.

<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</body>
</html>
</pre>

Cria-se o [[OpenLayers.Map|Map]] através do construtor [[OpenLayers.Map|OpenLaer.Map]], que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta vários data sources, WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como [[OpenLayers.Map|Map]] um [[OpenLayers.Layer.WMS|WMS]] da MetaCarta.

Para adicionar uma Layer ao Map, o construtor do Layer tem como parametros a URL do WMS server usado, e um objecto que contem os parametros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o center e zoom level.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para vizualizar o primeiro Mapa.

== Exemplos, passo a passo ==

http://openlayers.org/dev/examples/
e
http://trac.openlayers.org/wiki/UserRecipes

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Before Getting Started -- The Technologies Behind OpenLayers ==

We at !OpenLayers generally ''assume'' that everyone who comes to us is already a highly skilled web programmer. Such, however, is not always the case. Here we have assembled a few quick links to tutorials and the like on how to master the art of coding in !JavaScript, debug in Firebug, understand JSON, etc.

* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introduction to JavaScript] by the people at [http://mootools.net mootools].
* Four-part video series by [http://www.crockford.com/ Douglas Crockford] on [http://video.yahoo.com/watch/111593/1710507 Programming in JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introduction to JSON]
* [http://getfirebug.com/logging.html Debugging with Firebug]

== Obter o Código ==
Aquando do lançamento de nova versão estável, esta fica disponível na página de download, a saber [http://openlayers.org/ http://openlayers.org/download/].

Se a intenção for utilizar o [[OpenLayers]] em alguma aplicação web, pode ser incluido http://www.openlayers.org/api/OpenLayers.js na página em questão. Esta ligação disponibiliza a última versão estável existente.

Se está interessado na versão do momento, existe a possibilidade de a obter directamente do repositório de controlo de versões, no caso Subversion.
Qualquer falha encontrada pode ser reportada em [http://trac.openlayers.org/wiki/FilingTickets Submeter Falha]. Não esquecer que o [[OpenLayers]] está continuamente em desenvolvimento e a respectiva correcção pode já ter sido submetida.

Para obter a versão em desenvolvimento do repositório [http://subversion.tigris.org Subversion]:

<pre>
svn checkout http://svn.openlayers.org/trunk/openlayers/
</pre>

Qualquer pessoa pode ler o repositório. Se tiver um ''patch'' pode submetê-lo para a lista. As pessoas que contribuem frequentemente têm acesso de escrita.

Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].

OpenLayers Tutorial Pt

2008-09-28T20:14:53Z

Wiki-Nsosilva: /* Para Programadores */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante no processo de aprendizagem.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre, desenvolvido pela comunidade de software ''Open Source''.

''OpenLayers'' torna-se um projecto da Fundação de [www.gis.com GIS] de fonte aberta.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

TODO TODO TODO TODO
As a framework, OpenLayers is intended to separate map tools from map data so that all the tools can operate on all the data sources. This separation breaks the proprietary silos that earlier GIS revolutions have taught civilization to avoid. The mapping revolution on the public Web should benefit from the experience of history.

Como ''framework'', ''OpenLayers'' destina-se a separar ferramentas mapa dos dados do mapa, para que todas as ferramentas podem operar em todas as fontes de dados. Esta separação quebra os silos de proprietários que anteriores GIS revoluções ensinaram civilização para evitar. A revolução de mapeamento na Web pública deve beneficiar da experiência da história.

== "Olá Mundo" OpenLayers ==

http://openlayers.org/doc/

[[OpenLayers.Map|Map]] e [[OpenLayers.Map|Layer]] são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um [[OpenLayers.Map|Map]] guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do [[OpenLayers.Map|Map]] a informação é disponibilizada via [[OpenLayers.Layer|Layer]]'s, que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as tags html de tipo block-level, (como por exemplo TODO)

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa tag deste tipo

incluindo uma tag script para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página html.

<pre>
<html>
<head>
<title>OpenLayers Example</title>

<script src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</pre>

Cria-se o [[OpenLayers.Map|Map]] através do construtor [[OpenLayers.Map|OpenLaer.Map]], que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta vários data sources, WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como [[OpenLayers.Map|Map]] um [[OpenLayers.Layer.WMS|WMS]] da MetaCarta.

Para adicionar uma Layer ao Map, o construtor do Layer tem como parametros a URL do WMS server usado, e um objecto que contem os parametros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o center e zoom level.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para vizualizar o primeiro Mapa.

== Exemplos, passo a passo ==

http://openlayers.org/dev/examples/
e
http://trac.openlayers.org/wiki/UserRecipes

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Before Getting Started -- The Technologies Behind OpenLayers ==

We at !OpenLayers generally ''assume'' that everyone who comes to us is already a highly skilled web programmer. Such, however, is not always the case. Here we have assembled a few quick links to tutorials and the like on how to master the art of coding in !JavaScript, debug in Firebug, understand JSON, etc.

* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introduction to JavaScript] by the people at [http://mootools.net mootools].
* Four-part video series by [http://www.crockford.com/ Douglas Crockford] on [http://video.yahoo.com/watch/111593/1710507 Programming in JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introduction to JSON]
* [http://getfirebug.com/logging.html Debugging with Firebug]

== Obter o Código ==

Getting the Code

Releases are made available on the downloads page. Additionally, if you wish to use OpenLayers in a web application, you can include http://www.openlayers.org/api/OpenLayers.js in your page, to always get the latest release.

The code is also available in our Subversion repository. Using Subversion, you can keep up to the absolute bleeding edge of the code. If you wish to report a bug in the API, and you are able to use Subversion, please see if the bug has been fixed in Subversion first: OpenLayers is under rapid development, so things change quickly.

If you don't have Subversion or don't want to download the code, you can still try some live examples on openlayers.org. If you're familiar with JavaScript, try viewing the source of the examples to get an idea how the OpenLayers library is used.

OpenLayers is still undergoing rapid development, so expect a lot to change in the next few weeks and months. We need your support! Please check the wiki for the very latest updates and documentation, and thank you for taking an interest.

Downloading OpenLayers<a title="Link to this section" class="anchor" href="/wiki/HowToDownload#DownloadingOpenLayers"> ¶</a></h1>
<p>
Current Stable API URL is always <a href="http://openlayers.org/api/OpenLayers.js">http://openlayers.org/api/OpenLayers.js</a>
</p>
<p>
Current Version API URL is <a href="http://openlayers.org/api/2.6/OpenLayers.js">http://openlayers.org/api/2.6/OpenLayers.js</a>
</p>
<p>
Latest stable release: [<a href="http://openlayers.org/download/OpenLayers-2.6.tar.gz">.tar.gz</a>] [<a href="http://openlayers.org/download/OpenLayers-2.6.zip">.zip</a>]

</p>
<blockquote>
<p>
[<a href="http://openlayers.org/download/OpenLayers-2.6-withdocs.tar.gz">.tar.gz with docs</a>] [<a href="http://openlayers.org/download/OpenLayers-2.6-withdocs.zip">.zip with docs</a>]
</p>
</blockquote>
<p>
Older releases: <a href="http://openlayers.org/download/">http://openlayers.org/download/</a>
</p>

OpenLayers Tutorial Pt

2008-09-28T20:10:32Z

Wiki-Nsosilva: /* Para Programadores */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante no processo de aprendizagem.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre, desenvolvido pela comunidade de software ''Open Source''.

''OpenLayers'' torna-se um projecto da Fundação de [www.gis.com GIS] de fonte aberta.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [http://openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

As a framework, OpenLayers is intended to separate map tools from map data so that all the tools can operate on all the data sources. This separation breaks the proprietary silos that earlier GIS revolutions have taught civilization to avoid. The mapping revolution on the public Web should benefit from the experience of history.

== "Olá Mundo" OpenLayers ==

http://openlayers.org/doc/

[[OpenLayers.Map|Map]] e [[OpenLayers.Map|Layer]] são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um [[OpenLayers.Map|Map]] guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do [[OpenLayers.Map|Map]] a informação é disponibilizada via [[OpenLayers.Layer|Layer]]'s, que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as tags html de tipo block-level, (como por exemplo TODO)

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa tag deste tipo

incluindo uma tag script para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página html.

<pre>
<html>
<head>
<title>OpenLayers Example</title>

<script src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</pre>

Cria-se o [[OpenLayers.Map|Map]] através do construtor [[OpenLayers.Map|OpenLaer.Map]], que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta vários data sources, WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como [[OpenLayers.Map|Map]] um [[OpenLayers.Layer.WMS|WMS]] da MetaCarta.

Para adicionar uma Layer ao Map, o construtor do Layer tem como parametros a URL do WMS server usado, e um objecto que contem os parametros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o center e zoom level.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para vizualizar o primeiro Mapa.

== Exemplos, passo a passo ==

http://openlayers.org/dev/examples/
e
http://trac.openlayers.org/wiki/UserRecipes

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Before Getting Started -- The Technologies Behind OpenLayers ==

We at !OpenLayers generally ''assume'' that everyone who comes to us is already a highly skilled web programmer. Such, however, is not always the case. Here we have assembled a few quick links to tutorials and the like on how to master the art of coding in !JavaScript, debug in Firebug, understand JSON, etc.

* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introduction to JavaScript] by the people at [http://mootools.net mootools].
* Four-part video series by [http://www.crockford.com/ Douglas Crockford] on [http://video.yahoo.com/watch/111593/1710507 Programming in JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introduction to JSON]
* [http://getfirebug.com/logging.html Debugging with Firebug]

== Obter o Código ==

Getting the Code

Releases are made available on the downloads page. Additionally, if you wish to use OpenLayers in a web application, you can include http://www.openlayers.org/api/OpenLayers.js in your page, to always get the latest release.

The code is also available in our Subversion repository. Using Subversion, you can keep up to the absolute bleeding edge of the code. If you wish to report a bug in the API, and you are able to use Subversion, please see if the bug has been fixed in Subversion first: OpenLayers is under rapid development, so things change quickly.

If you don't have Subversion or don't want to download the code, you can still try some live examples on openlayers.org. If you're familiar with JavaScript, try viewing the source of the examples to get an idea how the OpenLayers library is used.

OpenLayers is still undergoing rapid development, so expect a lot to change in the next few weeks and months. We need your support! Please check the wiki for the very latest updates and documentation, and thank you for taking an interest.

Downloading OpenLayers<a title="Link to this section" class="anchor" href="/wiki/HowToDownload#DownloadingOpenLayers"> ¶</a></h1>
<p>
Current Stable API URL is always <a href="http://openlayers.org/api/OpenLayers.js">http://openlayers.org/api/OpenLayers.js</a>
</p>
<p>
Current Version API URL is <a href="http://openlayers.org/api/2.6/OpenLayers.js">http://openlayers.org/api/2.6/OpenLayers.js</a>
</p>
<p>
Latest stable release: [<a href="http://openlayers.org/download/OpenLayers-2.6.tar.gz">.tar.gz</a>] [<a href="http://openlayers.org/download/OpenLayers-2.6.zip">.zip</a>]

</p>
<blockquote>
<p>
[<a href="http://openlayers.org/download/OpenLayers-2.6-withdocs.tar.gz">.tar.gz with docs</a>] [<a href="http://openlayers.org/download/OpenLayers-2.6-withdocs.zip">.zip with docs</a>]
</p>
</blockquote>
<p>
Older releases: <a href="http://openlayers.org/download/">http://openlayers.org/download/</a>
</p>

OpenLayers Tutorial Pt

2008-09-28T20:09:37Z

Wiki-Nsosilva: /* Para Programadores */

[[Image:openlayer.org.png|thumb|right|370px|Possibilidade de comunicação do OpenLayers através de diversos protocolos.]]

== Introdução ==

[[OpenLayers]] é uma biblioteca JavaScript open-source, sob [[Berkeley Software Distribution|licença BSD]], que permite construir páginas web contendo
informação geo-espacial dinâmica e independente de servidor.
Implementa uma [[OpenLayers_API|API JavaSript]], ainda em desenvolvimento, que
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs
como o [http://code.google.com/apis/maps/index.html Google Maps] ou o [http://dev.live.com/virtualearth/ MSN Virtual Earth], desta feita, como software livre.
Criado pela [www.metacarta.com MetaCarta], que continua a desempenhar um papel activo no suporte e
gestão deste projecto, pertence desde de Novembro de 2007 à [[Open Source Geospatial Foundation]],
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.

== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante no processo de aprendizagem.

Ficam aqui algumas referências:
* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introdução ao JavaScript]
* [http://video.yahoo.com/watch/111593/1710507 Programação em JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introdução a JSON]
* [http://getfirebug.com/logging.html ''Debugging'' com o Firebug]
<small>Procuram-se outras referências em português</small>

== Para Programadores ==

O ''OpenLayers'' é uma biblioteca desenvolvida em ''JavaScript'' com o objectivo de exibir mapas e dados nele contidos nos navegadores Web mais modernos, sem qualquer tipo de dependência do lado do servidor. Implementa uma ''API'' em ''JavaScript'' (ainda em desenvolvimento) para a criação de aplicações geográficas baseadas em Web. É semelhante ao [http://code.google.com/apis/maps/index.html/ Google Maps] e ao [http://dev.live.com/virtualearth/ MSN Virtual Earth APIs], mas com uma grande diferença: O ''OpenLayers'' é software livre, desenvolvido pela comunidade de software ''Open Source''.

''OpenLayers'' torna-se um projecto da Fundação de [www.gis.com GIS] de fonte aberta.

Além disso, ''OpenLayers'' implementa métodos padrão de acessos a dados geográficos, como os protocolos [[WMS Web Mapping Service]] e [[WFS Web Feature Service]]. ''OpenLayers'' foi desenvolvida em ''JavaScript'' orientado aos objectos, usando componentes da ''Prototype.js'' e da biblioteca [openrico.org/ Rico]. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da ''framework'' [http://straytree.com/TestAnotherWay/doc/index.html Test.AnotherWay].

As a framework, OpenLayers is intended to separate map tools from map data so that all the tools can operate on all the data sources. This separation breaks the proprietary silos that earlier GIS revolutions have taught civilization to avoid. The mapping revolution on the public Web should benefit from the experience of history.

== "Olá Mundo" OpenLayers ==

http://openlayers.org/doc/

[[OpenLayers.Map|Map]] e [[OpenLayers.Map|Layer]] são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
Um [[OpenLayers.Map|Map]] guarda informação acerca do mapa: projecção base, extensão, unidades, etc.

Dentro do [[OpenLayers.Map|Map]] a informação é disponibilizada via [[OpenLayers.Layer|Layer]]'s, que sendo a fonte de informação, define como esta deve ser requerida e apresentada.

O [[OpenLayers]] suporta a inserção de mapas em quase todas as tags html de tipo block-level, (como por exemplo TODO)

Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa tag deste tipo

incluindo uma tag script para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página html.

<pre>
<html>
<head>
<title>OpenLayers Example</title>

<script src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
</pre>

Cria-se o [[OpenLayers.Map|Map]] através do construtor [[OpenLayers.Map|OpenLaer.Map]], que tem como o argumento o elemento HTML onde estará contido ou o seu ID

<pre>
var map = new OpenLayers.Map('map');
</pre>

O [[OpenLayers]] suporta vários data sources, WMS, Yahoo! Maps, WorldWind e etc.

Neste exemplo utiliza-se como [[OpenLayers.Map|Map]] um [[OpenLayers.Layer.WMS|WMS]] da MetaCarta.

Para adicionar uma Layer ao Map, o construtor do Layer tem como parametros a URL do WMS server usado, e um objecto que contem os parametros a serem anexados ao pedido WMS.

<pre>
var wms = new OpenLayers.Layer.WMS(
"http://labs.metacarta.com/wms/vmap0",
{'layers':'basic'} );
map.addLayer(wms);
</pre>

Para apresentar o mapa é preciso definir o center e zoom level.

A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.

Juntando todas as partes:
<pre>
<html>
<head>
<title>OpenLayers Example</title>
<script
src="http://openlayers.org/api/OpenLayers.js"></script>
</head>
<body>
<div style="width:100%; height:100%" id="map"></div>
<script defer="defer" type="text/javascript">
var map = new OpenLayers.Map('map');
var wms = new OpenLayers.Layer.WMS( "OpenLayers WMS",
"http://labs.metacarta.com/wms/vmap0", {layers: 'basic'} );
map.addLayer(wms);
map.zoomToMaxExtent();
</script>
</body>
</html>
</pre>

Tem-se o código HTML para vizualizar o primeiro Mapa.

== Exemplos, passo a passo ==

http://openlayers.org/dev/examples/
e
http://trac.openlayers.org/wiki/UserRecipes

Neste secção, vamos demonstrar alguns exemplos de como utilizar algumas das funcionalidades do ''OpenLayers''.

* Utilizar o ''OpenLayers'' numa página ''Web'', é simples e fácil. Para tal, basta incluir o seguinte código na página:

<pre>
<iframe
src="http://openlayers.org/viewer/"
width="400" height="200"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex1.png]]

* Para especificar, por exemplo, as coordenadas de latitude e longitude e o nível de zoom, utiliza-se os parâmetros ''URL'', ''Center'' e ''Zoom'':

<pre>
<iframe
src="http://openlayers.org/viewer/?center=39.5,-7&zoom=6"
width="100%" height="300"
scrolling="no"
marginwidth="0" marginheight="0"
frameborder="0">
</iframe>
</pre>

[[Image:qckttrlex2.png]]

Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor [[WMS]].

== Guia de Utilização ==
http://trac.openlayers.org/wiki/UserGuide

Adicionar um Overlay WMS

As Layers WMS tem a capacidade de sobrepor outras Layers WMS numa mesma projecção, definindo-se para tal como um Overlay.

Isto pode ser feito de diversas maneiras. Definir o parametro transparent como true é a melhor opção no caso WMS.

<small>Como adicionar um Overlay WMS transparente a um Map.</small>
<pre>
var twms = new OpenLayers.Layer.WMS( "World Map",

"http://world.freemap.in/cgi-bin/mapserv?",

{ map: '/www/freemap.in/world/map/factbooktrans.map',

transparent: 'true', layers: 'factbook',

format: 'png'} );

map.addLayer(twms);
</pre>

--->>>> imggtngstrtd2

Google Maps

Para criar um Google Map no OpenLayers é necessário incluir uma tag script Google Maps para o dominio em questão,

especificando a respectiva chave da Google Maps API.

<small>Example script URL for Google Maps</small>
<pre>
<script src="http://maps.google.com/maps?file=api&v=2&key=YourKey"
type="text/javascript"></script>
</pre>

Uma vez incluída a esta tag, basta adicionar um novo tipo de Layer ao Map:

<small>Creating a Hybrid Map, and adding it to the map</small>
<pre>
var google = new OpenLayers.Layer.Google( "Google", { type: G_HYBRID_MAP } );

map.addLayer(google);
</pre>

Neste exemplo é utilizado um mapa do tipo G_HYBRID_MAP, o G_SATELLITE_MAP também é suportado.

--->>>> imggtngstrtd1

== Funcionalidades Avançadas ==

Exemplo de uma app já com muita cena :)

== Fornecedores de Serviços ==
'''Features:'''
* Load map data from many sources:
** [[Web Map Service]]
** [[Web Feature Service]]
** [[Google Maps]]
** [[OpenStreetMap]]
** [[Virtual Earth]]
** [[Yahoo! Maps]]
** [[MapServer]]
** [[GeoServer]]
** [http://ka-map.maptools.org/ ka-Map]
** [[NASA World Wind|World Wind servers]]
** [[GeoRSS]] support

== Outros Recursos ==
http://dev.openlayers.org/apidocs/index/General.html

http://trac.openlayers.org/

http://trac.openlayers.org/wiki/UML

== Before Getting Started -- The Technologies Behind OpenLayers ==

We at !OpenLayers generally ''assume'' that everyone who comes to us is already a highly skilled web programmer. Such, however, is not always the case. Here we have assembled a few quick links to tutorials and the like on how to master the art of coding in !JavaScript, debug in Firebug, understand JSON, etc.

* [http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Introduction to JavaScript] by the people at [http://mootools.net mootools].
* Four-part video series by [http://www.crockford.com/ Douglas Crockford] on [http://video.yahoo.com/watch/111593/1710507 Programming in JavaScript]
* [http://javascript.crockford.com/ Crockford's JavaScript page]
* [http://www.json.org/ Introduction to JSON]
* [http://getfirebug.com/logging.html Debugging with Firebug]

== Obter o Código ==

Getting the Code

Releases are made available on the downloads page. Additionally, if you wish to use OpenLayers in a web application, you can include http://www.openlayers.org/api/OpenLayers.js in your page, to always get the latest release.

The code is also available in our Subversion repository. Using Subversion, you can keep up to the absolute bleeding edge of the code. If you wish to report a bug in the API, and you are able to use Subversion, please see if the bug has been fixed in Subversion first: OpenLayers is under rapid development, so things change quickly.

If you don't have Subversion or don't want to download the code, you can still try some live examples on openlayers.org. If you're familiar with JavaScript, try viewing the source of the examples to get an idea how the OpenLayers library is used.

OpenLayers is still undergoing rapid development, so expect a lot to change in the next few weeks and months. We need your support! Please check the wiki for the very latest updates and documentation, and thank you for taking an interest.

Downloading OpenLayers<a title="Link to this section" class="anchor" href="/wiki/HowToDownload#DownloadingOpenLayers"> ¶</a></h1>
<p>
Current Stable API URL is always <a href="http://openlayers.org/api/OpenLayers.js">http://openlayers.org/api/OpenLayers.js</a>
</p>
<p>
Current Version API URL is <a href="http://openlayers.org/api/2.6/OpenLayers.js">http://openlayers.org/api/2.6/OpenLayers.js</a>
</p>
<p>
Latest stable release: [<a href="http://openlayers.org/download/OpenLayers-2.6.tar.gz">.tar.gz</a>] [<a href="http://openlayers.org/download/OpenLayers-2.6.zip">.zip</a>]

</p>
<blockquote>
<p>
[<a href="http://openlayers.org/download/OpenLayers-2.6-withdocs.tar.gz">.tar.gz with docs</a>] [<a href="http://openlayers.org/download/OpenLayers-2.6-withdocs.zip">.zip with docs</a>]
</p>
</blockquote>
<p>
Older releases: <a href="http://openlayers.org/download/">http://openlayers.org/download/</a>
</p>