Difference between revisions of "OpenLayers Tutorial Pt"

From OSGeo
Jump to navigation Jump to search
 
(36 intermediate revisions by 2 users not shown)
Line 9: Line 9:
 
permite a construção de aplicações geográficas ''web-based'', disponibilizando APIs  
 
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.
 
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  
+
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]],  
 
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.
 
que apoia e promove o desenvolvimento cooperativo de tecnologias e dados geo-espaciais.
  
 
== Antes de começar ==
 
== Antes de começar ==
O desenvolvimento do [[OpenLayers]] é feito tendo por base outras tecnologias. O domínio/conhecimento destas é relevante no processo de aprendizagem.
+
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:
 
Ficam aqui algumas referências:
Line 26: Line 26:
 
== Para Programadores ==
 
== 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''.  
+
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''.  
  
''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 [[Web Map Service]] (WMS) e [[Web Feature Service]] (WFS). ''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].
  
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:
  
TODO TODO TODO TODO
+
<pre>
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.
+
<iframe
 +
      src="http://openlayers.org/viewer/"
 +
      width="400" height="200"
 +
      scrolling="no"
 +
      marginwidth="0" marginheight="0"
 +
      frameborder="0">
 +
</iframe>
 +
</pre>
  
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.
+
[[Image:qckttrlex1.png]]
  
== "Olá Mundo" OpenLayers ==
+
* 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>
  
http://openlayers.org/doc/
+
[[Image:qckttrlex2.png]]
  
 +
Estes exemplos utilizam mapas, recebendo-os dinamicamente de um servidor WMS.
  
[[OpenLayers.Map|Map]] e [[OpenLayers.Map|Layer]] são dois conceitos importantes na construção de um mapa com o API [[OpenLayers]].
+
== "Olá Mundo" 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.
+
''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.
  
O [[OpenLayers]] suporta a inserção de mapas em quase todas as tags html de tipo block-level, (como por exemplo TODO)
+
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.
  
Para construir um visualizador [[OpenLayers]] numa página web, basta inseri-lo numa tag deste tipo
+
O [[OpenLayers]] suporta a inserção de mapas em quase todas as ''tag HTML'' de tipo ''block-level''.
incluindo uma tag script para incluir a [[OpenLayers_API|biblioteca OpenLayers]] no código da página html.
+
 
 +
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>
 
<pre>
    <html>
+
<html>
    <head>
+
<head>
      <title>OpenLayers Example</title>
+
  <title>OpenLayers Example</title>
      <script src="http://openlayers.org/api/OpenLayers.js"></script>
+
    <script
 +
    src="http://openlayers.org/api/OpenLayers.js"></script>
 
     </head>
 
     </head>
 
     <body>
 
     <body>
          <div style="width:100%; height:100%" id="map"></div>
+
      <div style="width:100%; height:100%" id="map"></div>
 +
</body>
 +
</html>
 
</pre>  
 
</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
+
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>
 
<pre>
Line 72: Line 98:
  
  
O [[OpenLayers]] suporta vários data sources, WMS, Yahoo! Maps, WorldWind e etc.
+
O [[OpenLayers]] suporta várias origens de dados WMS, Yahoo! Maps, WorldWind e etc.
  
Neste exemplo utiliza-se como [[OpenLayers.Map|Map]] um [[OpenLayers.Layer.WMS|WMS]] da MetaCarta.
+
Neste exemplo utiliza-se como ''Map'' um 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.
+
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.
  
  
Line 86: Line 112:
 
</pre>
 
</pre>
  
Para apresentar o mapa é preciso definir o center e zoom level.
+
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.
 
A função ''''zoomToMaxExtent'''' permite fazer com que o mapa encaixe no tamanho da janela com o maior zoom possível.
Line 111: Line 137:
 
</pre>
 
</pre>
  
Tem-se o código HTML para vizualizar o primeiro Mapa.
+
Tem-se o código HTML para visualizar o primeiro Mapa.
  
== Exemplos, passo a passo ==
+
== Fornecedores de Serviços ==
 
 
 
 
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'':
+
No [http://mapas.igeo.pt/ m@pas on-line] podem ter acesso a um catálogo de serviços [[Web Map Service]] WMS e [[Web Feature Service]] WFS portugueses. A oferta disponível ao público é bastante vasta.
 
 
<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 ==
 
== 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]
 
  
 +
* [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://geo.algarvedigital.pt/ Mapa interactivo do Algarve - Algarve Digital]
 +
* [http://www.valedominhodigital.pt/portal/page/portal/Portal_Regional Vale do Minho Digital]
 +
* [http://trac.openlayers.org/ OpenLayers]
 +
* [http://udig.refractions.net/ GIS Framework para o Eclipse]
  
 
== Obter o Código ==
 
== Obter o Código ==
Line 261: Line 171:
  
 
Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].
 
Para mais informações, seguir até [http://trac.openlayers.org/wiki/HowToDownload Download OpenLayers].
 +
 +
[[Category:Portugal]]

Latest revision as of 10:17, 27 October 2008

Possibilidade de comunicação do OpenLayers através de diversos protocolos.


Introdução

OpenLayers é uma biblioteca JavaScript open-source, sob licença BSD, que permite construir páginas web contendo informação geo-espacial dinâmica e independente de servidor. Implementa uma API JavaSript, ainda em desenvolvimento, que permite a construção de aplicações geográficas web-based, disponibilizando APIs como o Google Maps ou o MSN Virtual Earth, desta feita, como software livre. Criado pela 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:

Procuram-se outras referências em português

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 Google Maps e ao 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 (WMS) e Web Feature Service (WFS). OpenLayers foi desenvolvida em JavaScript orientado aos objectos, usando componentes da Prototype.js e da biblioteca Rico. O código até hoje desenvolvido foi já submetido a centenas de testes de unidade, através da framework 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:
<iframe
      src="http://openlayers.org/viewer/"
      width="400" height="200"
      scrolling="no"
      marginwidth="0" marginheight="0"
      frameborder="0">
 </iframe>

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:
<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>

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 biblioteca OpenLayers no código da página HTML.


<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>


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

    var map = new OpenLayers.Map('map');


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.


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

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:

<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>

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

Fornecedores de Serviços

No m@pas on-line podem ter acesso a um catálogo de serviços Web Map Service WMS e Web Feature Service WFS portugueses. A oferta disponível ao público é bastante vasta.

Outros Recursos

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/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 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 Subversion:

svn checkout http://svn.openlayers.org/trunk/openlayers/

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é Download OpenLayers.