Documentación técnica y de usuario Soporte para capas georss

Transcripción

1 Soporte para capas georss Jorge Gaspar Sanz Salinas Este documento se distribuye bajo una licencia Creative Commons SA versión 3.0. Ver Apéndice C, Licencia: Creative Commons 3.0 SA. Todos los nombres propios de programas, sistemas operativos, equipo hardware, etc., que aparecen en este documento son marcas registradas de sus respectivas compañías u organizaciones. Copyright Historial de revisiones Revisión agosto-2007 jsanz Creación del documento Revisión agosto-2007 jsanz Resumen Primera versión con documentación de usuario Documentación técnica y de usuario del proyecto Soporte para capas georss. Este plugin de gvsig permite añadir capas de noticias de forma sencilla, incluso aunque no dispongan inicialmente del estándar georss. Tabla de contenidos 1. Introducción Documentación de usuario Requisitos previos Instalación del plugin Carga de la capa de noticias de meneame.net Carga de una capa georss Ver las propiedades de la capa Ver una noticia... 8 A. Referencias... 9 B. Definiciones... 9 C. Licencia: Creative Commons 3.0 SA Introducción La idea tras este plugin es principalmente aprender. Es decir, no surge de una necesidad en un proyecto profesional concreto (al menos no directamente, porque todo esto lo he podido aplicar a posteriori en el trabajo) sino más bien de la necesidad general de conocer un poco más la arquitectura de gvsig, su organización interna y diferentes partes del proyecto que todavía no conocía muy bien, como la persistencia de datos, los orígenes de datos, etc. Además, me ha servido para experimentar con dos bibliotecas que quería probar (y nada mejor que un proyecto real para ello): Una biblioteca de parseo de documentos XML: [jdom] 1

2 Una biblioteca que permite insertar contenido HTML dentro una aplicación Java: [cobra] Aviso Otro objetivo era practicar con DocBook como sistema de generación de documentación de usuario y documentación técnica del proyecto. Creo en este sentido que DocBook tiene mucho que ofrecer al proyecto gvsig en general ya que la adopción del mismo podría favorecer enormemente la difusión del mismo al generar documentación tanto en formato HTML como en PDF y demás. He separado este documento en dos partes principales, una primera parte es una pequeña documentación de usuario, suficiente para el que no esté interesado en desarrollar extensiones con gvsig. Es corta a la fuerza, no hay tanto desarrollado :P. La segunda creo que es más interesante porque en ella intentaré recoger todo aquello que crea que puede ser interesante sobre el diseño de la extensión, partes implicadas, etc. No prometo grandes alardes ya que esto lo estoy haciendo con la extensión acabada y con animo de «cerrar» este pequeño proyecto. En general, salvo que el contexto indique otra cosa, la palabra extensión es análoga a la de plugin. Esto es cierto en toda la documentación de usuario. En la documentación técnica será necesario hacer la distinción entre ambos conceptos, tal y como aclara la definición de plugin en el Apéndice B, Definiciones. 2. Documentación de usuario Muchas páginas de noticias en Internet proporcionan sus contenidos a través del estándar RSS. Desde hace poco algunas empiezan a emplear un nuevo estándar llamado georss para ubicar dichos contenidos. Un ejemplo es meneame.net [ pero hay muchas más. Si nos fijamos en una sección del archivo XML que se descargaría nuestro lector de noticias (por ejemplo de meneame.net [ veríamos algo como lo mostrado en la Figura 1, Ejemplo de noticia en el RSS de meneame.net. Figura 1. Ejemplo de noticia en el RSS de meneame.net [ Así, con la extensión que se presenta, es posible ver estas noticias sobre una vista de gvsig como un origen de puntos más, pudiendo además acceder de forma sencilla a las noticias a través ya de nuestro navegador web. Vamos allá Requisitos previos El único requisito previo para utilizar esta extensión es disponer de una instalación operativa de gv- SIG que utilice la máquina virtual Java con versión 1.5 o posterior. Esto se puede comprobar en la 2

3 información de gvsig a la que se accede desde Ayuda # Acerca de... En la parte inferior derecha aparece la versión de la JVM (Figura 2, Viendo la versión de la JVM que ejecuta gvsig ). Figura 2. Viendo la versión de la JVM que ejecuta gvsig 2.2. Instalación del plugin De momento no hay instalador para el proyecto. Por esta razón la instalación del mismo es completamente manual. En cualquier caso es sencilla. Supongamos que tenemos instalado gvsig en la carpeta C:\Archivos de Programa\gvSIG. Los pasos lógicos serán: Atención 1. Descargar el fichero con los binarios gvsig-georss-bin-bnxxx.zip. 2. Descomprimir el fichero en alguna carpeta temporal (por ejemplo en C:\TEMP). Se crearán dos carpetas com.iver.cit.gvsig net.geomaticblog.georss 3. Copiar ambas carpetas a la carpeta extensiones de gvsig que estará en C:\Archivos de Programa\gvSIG\bin\gvSIG\extensiones 3

4 La primera carpeta ya existe! Esa es la carpeta donde se encuentra la mayor parte de gvsig. Sólo tienes que copiar los contenidos nuevos y listo. 4. Comprobar que se ha cargado la extensión abriendo gvsig y accediendo a Ayuda # Acerca de... Deberá aparecer una pestaña nueva con la etiqueta georss que mostrará una bonita ventana con los créditos de la extensión (Figura 3, Pestaña de la extensión en la ventana Acerca de... ). Figura 3. Pestaña de la extensión en la ventana Acerca de Carga de la capa de noticias de meneame.net Nada más sencillo, carga una nueva vista seleccionando como proyección la correspondiente al elipsoide WGS84 en coordenadas geográficas (Figura 4, Seleccionando la proyección EPSG:4326 ). 4

5 Figura 4. Seleccionando la proyección EPSG:4326 A continuación sólo tienes que pulsar el botón con el logotipo de meneame.net [ la elefanta «Eli» (Figura 5, Añadiendo la capa de noticias de meneame.net ). Si todo va bien, deberías ver en breve una nueva capa cuyo nombre es «Meneame: publicadas» (Figura 6, Viendo las noticias de meneame.net en gvsig ). Figura 5. Añadiendo la capa de noticias de meneame.net [ 5

6 Figura 6. Viendo las noticias de meneame.net [ en gvsig 2.4. Carga de una capa georss Cargar una capa georss es igualmente sencillo. Los pasos habituales serían: 1. Copiar desde tu navegador el enlace al origen de datos RSS (suele aparecer en o junto al icono ). Sugerencia 2. En gvsig, presionar el botón para que aparezca el diálogo que solicita la dirección del origen de datos. Si tienes en el portapapeles la dirección, ésta aparecerá automáticamente en el diálogo sin necesidad de pegarla. Somos así de atentos los programadores :P Figura 7. Cargando una capa georss 6

7 3. Si el origen de datos dispone de información georss automáticamente aparecerá en gvsig una nueva capa con las noticias. En caso contrario aparecerá un mensaje que indicará que se va a pasar por geonames.org para intentar obtener información geográfica a partir de los textos y títulos de las noticias. Sugerencia Este servicio permite por ejemplo poder mostrar noticias de periódicos con bastante éxito ya que suelen dar bastante información en forma de topónimos. Figura 8. Pasando una capa por geonames.org Nota Este botón es ciertamente una forma no muy estándar de añadir la capa, siendo la ubicación idónea de la interfaz dentro de las pestañas del diálogo Vista # Añadir capa (Control+O). Se ha hecho así por pura comodidad del que programa y ciertamente es una de las partes más mejorables de la extensión Ver las propiedades de la capa Es posible ver algo de información sobre una capa en concreto se muestra: Nombre de la capa Enlace al sitio que publica las noticias (se abre nuestro navegador web) Fecha de publicación de las noticias (si se proporciona) Un resumen del sitio que publica las noticias 7

8 Figura 9. Viendo las propiedades de la capa Nota La ubicación lógica de esta información es en el diálogo de propiedades genérico de la capa. En un futuro cercano este diálogo será extensible y por lo tanto se dispondrá de un único diálogo para las propiedades de la capa, independientemente de si su origen es un servidor WMS, ArcIMS o georss Ver una noticia Nota Una vez cargada una capa, tendremos sobre nuestra vista un conjunto de puntos que ubican noticias. Para ver una noticia debemos seleccionar la herramienta de consulta. Con esta herramienta activada basta con pinchar sobre una noticia para que esta se muestre en un diálogo similar al de propiedades de la vista. Este diálogo permite igualmente acceder al enlace de la noticia original. Para ello se debe pinchar sobre el título de la noticia. Al pasear el ratón sobre las noticias, si te detienes sobre una noticia, se muestra en el tooltip del ratón el titular de la noticia por lo que no es necesario abrir la noticia para verlo. Al contrario que la herramienta de información por punto (Vista # Consulta # Información), esta herramienta no necesita que haya una capa georss activa. Al pinchar sobre una ubicación buscará en todas las capas y devolverá la primera respuesta. 8

9 Figura 10. Viendo una noticia A. Referencias [georss] georss. [gvsig] Proyecto gvsig, el SIG libre de la Generalitat Valenciana. Conselleria d'infraestructures i Transports, Generalitat Valenciana. [jdom] Java Document Object Model library (JDOM). [cobra] COBRA, renderer de HTML para Java. [piera] Tutorial de creación de extensiones en gvsig. Jorge Piera. Cursos y tutoriales de gvsig [ B. Definiciones geonames.org georss Sitio web que mantiene una base de datos de toponimos de uso gratuito, ofreciendo diversas formas de acceso para programadores mediante una intefaz de aplicación (API). En esta extensión se utiliza un servicio que permite convertir un origen RSS en otro georss. Extensión de RSS que permite indicar en cualquier noticia del feed su ubicación geográfica. En general se realizará mediante un punto en coordenadas geográficas utilizando el elipsoide del sistema GPS, el WGS84, pero el estándar permite añadir de diferentes modos tanto puntos como líneas o polígonos. Se puede entender este estándar como una alternativa sencilla a KML 9

10 el formato empleado por Google Earth. JVM Plugin RSS Acrónimo de Java Virtual Machine. La máquina virtual Java es el componente de software que permite ejecutar programas realizados en este lenguaje de programación. Este componente debe instalarse previamente. gvsig por ejemplo, dispone de un instalador que se encarga de colocar la JVM correcta para asegurar su correcto funcionamiento. Un plugin en general para gvsig es un conjunto de una o más extensiones que añaden cierta funcionalidad. Así, por ejemplo, un plugin puede añadir una pestaña a la ventana «Acerca de...», alguna entrada a los menús contextuales de capa en una vista y algún otro botón en la barra de herramientas. Acrónimo de Really Simple Syndication. Se trata de un estándar para la difusión de noticias. En concreto es una variante del lenguaje XML que permite que cualquier sitio de noticias publique sus noticias de tal forma que cualquier programa que entienda este estándar es capaz de mostrar al usuario final (que no ve XML en ningún momento) las noticias de sus sitios favoritos. Estos programas se llaman agregadores y existen en versiones de escritorio (BlogBridge [ Liferea [ como en versión web: ( Google Reader [ Bloglines [ Netvibes [ por otro lado mucho más populares. C. Licencia: Creative Commons 3.0 SA You are free: To Share - to copy, distribute and transmit the work To Remix - to adapt the work Under the following conditions: Attribution. You must attribute the work in the manner specified by the author or licensor (but not in any way that suggests that they endorse you or your use of the work). Share Alike. If you alter, transform, or build upon this work, you may distribute the resulting work only under the same, similar or a compatible license. And: For any reuse or distribution, you must make clear to others the license terms of this work. The best way to do this is with a link to this web page. Any of the above conditions can be waived if you get permission from the copyright holder. Nothing in this license impairs or restricts the author's moral rights. Para consultar los términos detallados de la licencia de distribución vaya a 10