Título. Identificador

Transcripción

1 Título Identificador Guía para la publicación de información geográfica a través de Web Map Services -WMS GU-01 Autor Infraestructura de Datos Espaciales para el Distrito Capital Leonardo Montero Leguizamón. Fecha de creación Descripción Publicador Colaboradores Tipo Formato Fuente Idioma Cobertura Derechos Palabras claves En esta guía se explica cómo instalar y configurar un servidor para la publicación de WMS. UAECD. Texto. Microsoft Word (.doc) IDECA Procedimiento para la publicación de información geográfica de Bogotá Distrito Capital. Español. Bogotá Distrito Capital Copyright. Publicación, Política, Servicio de mapas Página 1 de 36

2 Fecha Autor/ Modificado por Versión Cambio efectuado Leonardo Leguizamón Montero 1.0 Primera versión del documento. No hay cambios para registrar. Página 2 de 36

3 1. Introducción Población Objetivo Recomendaciones Desarrollo Instalación de Apache Tomcat Verificar el Funcionamiento De Apache Tomcat Configurar Apache Tomcat para que ejecute programas Common Gateway Interface - CGI Publicación de Información Geográfica utilizando MapServer Instalar MapServer en Apache Tomcat Publicar información Configurar el servicio de MapServer como un WMS Probar el servicio WMS Publicación de Información Geográfica utilizando GeoServer Instalación de GeoServer Probar el funcionamiento del GeoServer Crear un nuevo espacio de trabajo Crear un almacén de datos para los datos en formato Vector Crear un almacén de datos para los datos en formato Raster Probar el servicio WMS Referencias Página 3 de 36

4 Gracias al avance de Internet, las tecnologías de la información y comunicaciones han tenido una gran evolución que ha permitido el desarrollo de nuevas iniciativas y proyectos encaminados a compartir recursos, intercambiar información, realizar procesos, desarrollar trámites, promover el comercio electrónico y facilitar el acceso de todos los ciudadanos a la información y servicios de forma interoperable. Es por esto, que en el marco de IDECA, el acceso, integración y distribución de la información geográfica es realizada por medios telemáticos en línea, principalmente a través de Internet, sin importar la plataforma o tecnología que posean o utilicen las entidades del Distrito. Es así, como los Servicios Web, son uno de los mecanismos de comunicación más útiles en este ámbito. En este contexto, se ha desarrollado la siguiente guía en la cual se describe un paso a paso de cómo publicar información en diferentes aplicaciones, con el fin de que las entidades del Distrito Capital pongan su información al alcance de todos los usuarios. PALABRA CLAVES: Disposición, acceso y uso, WMS, OGC, estándar, servicios web, servicios de mapas. Página 4 de 36

5 Esta guía está dirigida a todos los profesionales de Bogotá Distrito Capital interesados en la publicación de la información geográfica utilizando estándares tecnológicos que permitan el intercambio y uso de dicha información. Página 5 de 36

6 Un servicio web es definido como un conjunto de aplicaciones o de tecnologías que intercambian datos entre sí, con el objetivo de ofrecer unos servicios a través de la web. Las tecnologías en que se basan estos servicios son totalmente abiertas, las especificaciones son totalmente públicas; son estándar, no existen problemas de incompatibilidades entre versiones y sobre todo gozan de una gran simplicidad que las hacen muy accesibles 1. Algunas recomendaciones acerca del uso de estos servicios son: Utilizar herramientas interoperables. Existen muchas herramientas SIG disponibles en el mercado que soportan estos estándares, esto hace de los servicios de mapas una forma de distribución de información realmente interoperable. Garantizar el funcionamiento continuo de los servicios. Muchos usuarios desconfían del uso de servicios web aduciendo que estos son intermitentes y poco confiables en términos de rendimiento, es importante garantizar la disposición de la información para que los usuarios no tengan que buscar información alterna o servicios de otras fuentes o solicitarla por medio físico. Implementar catálogos de servicios. Se deben proveer herramientas a los usuarios para encontrar servicios de mapas. Pocas personas hacen uso de Internet como herramienta para buscar servicios de mapas y aquellas que lo intentan comúnmente encuentran información disponible para descarga pero no servicios. Proveer herramientas para consultar los metadatos de los servicios de mapas. Los servicios de mapas con metadatos son más fáciles de utilizar. Tener en cuenta factores como escala de despliegue, extensión geográfica, resolución temporal de los datos, etc. del servicio de mapas. Si un usuario encuentra que la información de un servicio de mapas, no cumple con sus requerimientos es muy probable que prefiera buscar la información de otras fuentes para descargarla localmente y luego importarla. Optimizar los servicios de mapas para su despliegue. Consumir un servicio de mapas creado a partir de información vector requiere un tiempo de carga y visualización importante cuando se compara con su carga y visualización de manera local. Consolidar un catálogo de símbolos. Al consumir un servicio de mapas no es posible manipular la simbología de sus capas. Si se cuenta con un catálogo de símbolos para el Distrito, cuando la información sea publicada, su representación cartográfica no corresponderá al criterio de la persona que preparó y publicó el servicio, sino a un esquema de estandarización que permita una fácil interpretación de la información. Tenga presente que este se encuentra soportado bajo un catálogo de objetos geográficos. 1 Página 6 de 36

7 Abrir la carpeta de instaladores entregada y ejecutar el archivo apache-tomcat exe Seguir las indicaciones del instalador, al llegar a la pantalla de selección de componentes de la instalación seleccionar la opción Normal en el tipo de instalación. Dar click en el botón Next. En la pantalla de configuración básica Configuration, dejar los puertos por defecto y en las opciones de autenticación del administrador de Tomcat agregar admin como nombre de usuario y admin como contraseña. Dar click en el botón Next Página 7 de 36

8 En la pantalla de selección de la máquina virtual de Java Java Virtual Machine, indicar la ruta de acceso al JRE. Dar click en el botón Next En la pantalla selección de la ruta de instalación Choose Install Location, ingresar la ruta C:\Tomcat60\. Dar click en el botón Install Página 8 de 36

9 Seguidamente comienza el proceso de transferencia de archivos. Dar click en el botón Finish para finalizar el proceso de instalación. Dar click en el botón de inicio de Windows, seleccionar la opción ejecutar, escribir services.msc, dar click en el botón Aceptar A continuación se abre el panel de servicios de Windows. Buscar un servicio llamado Apache Tomcat 6.0 y verificar que su estado sea Iniciado, de lo contrario iniciar el servicio haciendo click en el link Iniciar o en el botón Página 9 de 36

10 Una vez se ha iniciado el servicio, abrir un navegador de internet y acceder a la URL Se debe desplegar una página como la siguiente Página 10 de 36

11 Este paso es requerido para poder ejecutar correctamente el software MapServer en Apache Tomcat. En una ventana de navegador de archivos, ir a la carpeta C:\Tomcat60\conf y buscar el archivo web.xml, en este archivo buscar la sección de configuración del servlet de procesamiento de programas CGI de Apache Tomcat (Buscar la palabra cgi en el contenido del archivo, que se encuentre al interior de un grupo de elementos que inicie con la etiqueta <servlet>). Una vez se ha encontrado esta sección se deben remover los comentarios (caracteres <! y --> al inicio y al final de la sección). Agregar las siguientes líneas antes del final de la sección: <init-param> <param-name>executable</param-name> <param-value></param-value> </init-param> La sección de configuración del servlet de procesamiento de programas CGI del archivo web.xml quedará de la siguiente forma: Página 11 de 36

12 Buscar la sección servlet mapping para CGI (Buscar la palabra cgi en el contenido del archivo, que se encuentre al interior de un grupo de elementos que inicie con la etiqueta <servlet-mapping>). Remover los comentarios (caracteres <! y -->) de esta sección. La sección servlet mapping del archivo web.xml quedará de la siguiente forma: Abrir el archivo de configuración context.xml y agregar la propiedad privileged="true" al inicio de la sección context (dentro de la etiqyeta de inicio de la sección context). El archivo quedará de la siguiente forma: Página 12 de 36

13 Crear la carpeta cgi en la ruta C:\Tomcat60\webapps\ROOT\WEB-INF\ (Esta carpeta es utilizada por Apache Tomcat para ejecutar programas CGI), y descomprimir en ella el contenido del archivo mapserver rar que se encuentra en la carpeta de instaladores. Dar click en el botón de inicio de Windows, seleccionar la opción ejecutar, escribir services.msc, dar click en el botón Aceptar Página 13 de 36

14 A continuación se abre el panel de servicios de Windows, dentro de este se debe buscar el servicio Apache Tomcat 6.0, seleccionarlo y haciendo click con el botón derecho del mouse sobre él, seleccionar la opción Reiniciar del menú de contexto que se despliega. De manera alternativa se puede dar click en el link Reiniciar del panel principal o en el botón de la barra de herramientas principal Finalmente, verificar que el estado del servicio sea Iniciado, de lo contrario iniciar el servicio haciendo click en el link Iniciar del panel principal o en el botón de la barra de herramientas principal Abrir un navegador de internet y navegar a la URL Debe aparecer el siguiente mensaje: Página 14 de 36

15 También se puede el funcionamiento de MapServer desde una ventana de comandos, ubicándose en la carpeta C:\Tomcat60\webapps\ROOT\WEB-INF\cgi\ y ejecutando el comando mapserv.exe v. La ejecución de este comando debe retornar un mensaje como el que aparece a continuación. Descomprimir el archivo geoservicios.rar en la ruta C:\Tomcat60\webapps\ROOT. (Al explorar la carpeta descomprimida, debe aparecer dentro de ella las carpetas data y mapfiles) Página 15 de 36

16 La carpeta data contiene la información que va a ser publicada a través de los servicios WMS que se van a crear más adelante; la carpeta mapfiles es el lugar donde se van a generar los archivos de configuración de los servicios WMS de MapServer Dentro de la carpeta mapfiles, crear un archivo de texto llamado wmsmapserver.txt y cambiar su extensión a.map, abrir el archivo en un editor de texto. Copiar el siguiente texto en el nuevo archivo creado MAP IMAGETYPE PNG EXTENT SIZE SHAPEPATH "../data" IMAGECOLOR LAYER NAME manzanas DATA shapefiles/manzanas STATUS OFF TYPE POLYGON CLASS NAME "DEFAULT" STYLE COLOR OUTLINECOLOR LAYER NAME mosaico2009 DATA "raster/mosaico2009.tif" STATUS OFF TYPE RASTER PROCESSING "BANDS=1,2,3" OFFSITE Para probar el funcionamiento del servicio creado se debe acceder a la siguiente URL: Página 16 de 36

17 En la ventana del navegador debe desplegarse una imagen como la siguiente Nota: Aunque el orden de los elementos que componen un mapfile no es determinante para el funcionamiento de un servicio WMS, se recomienda dejar al inicio del mapfile las variables de configuración del servicio y luego hacer las declaraciones de las capas (objetos LAYER) Agregar los siguientes elementos al mapfile: A nivel MAP: Los siguientes elementos deben ser copiados en cualquier parte del archivo mapfile, dentro del objeto MAP CONFIG PROJ_LIB "C:\Tomcat60\webapps\ROOT\WEB-INF\cgi\proj" NAME "wmsmapserver" PROJECTION "init=epsg:4686" WEB METADATA "wms_title" "wms_title" "WMS Mapserver" "WMS Mapserver" Página 17 de 36

18 "wms_onlineresource" " "wms_srs" "EPSG:4686" "ows_enable_request" "*" A nivel LAYER (mosaico): Los siguientes elementos deben ser copiados en cualquier parte del archivo mapfile, dentro del objeto LAYER correspondiente a la información raster METADATA "wms_title" "wms_srs" "mosaico2009" "EPSG:4686" A nivel LAYER (manzanas): Los siguientes elementos deben ser copiados en cualquier parte del archivo mapfile, dentro del objeto LAYER correspondiente a la información vectorial METADATA "wms_title" "wms_srs" "manzanas" "EPSG:4686" Al finalizar ese paso, el contenido del mapfile deberá ser similar al siguiente: MAP CONFIG PROJ_LIB "C:\Tomcat60\webapps\ROOT\WEB-INF\cgi\proj" NAME "wmsmapserver" IMAGETYPE PNG EXTENT SIZE SHAPEPATH "../data" IMAGECOLOR PROJECTION "init=epsg:4686" WEB METADATA "wms_title" "WMS Mapserver" "wms_title" "WMS Mapserver" "wms_onlineresource" " "wms_srs" "EPSG:4686" "ows_enable_request" "*" Página 18 de 36

19 LAYER NAME mosaico2009 DATA "raster/mosaico2009.tif" STATUS OFF TYPE RASTER PROCESSING "BANDS=1,2,3" OFFSITE METADATA "wms_title" "wms_srs" "mosaico2009" "EPSG:4686" LAYER NAME DATA STATUS TYPE manzanas shapefiles/manzanas OFF POLYGON METADATA "wms_title" "wms_srs" "manzanas" "EPSG:4686" CLASS NAME "DEFAULT" STYLE COLOR OUTLINECOLOR Para probar el funcionamiento del servicio WMS se debe enviar una petición mediante nuestro navegador. Petición GetCapabilities Petición GetMap osaico2009,manzanas&styles=&bbox= ,4.62, ,4.627&width=850&height=495&srs=epsg:4686&format=image/png Página 19 de 36

20 Página 20 de 36

21 En una explorador de archivos, navegar a la carpeta C:\Tomcat60\webapps, en ella copiar el archivo geoserver.war que se encuentra en la carpeta de instaladores. Esperar unos segundos, debe refrescarse el contenido y aparecerá una nueva carpeta llamada geoserver. Abrir una ventana de navegador, acceder a la URL Cuando la página solicite autenticación del usuario, ingresar los valores de admin para el nombre de usuario, y admin para la contraseña (estos hicieron parte de la instalación de Apache Tomcat). Se debe desplegar una ventana como la siguiente: Página 21 de 36

22 Ir a la sección Desplegar - Archivo WAR a desplegar, dar click en el botón Seleccionar archivo. En la ventana de diálogo que se despliega, navegar a la carpeta de instaladores y seleccionar el archivo geoserver.war. De regreso en la ventana principal, dar click en el botón Desplegar. Esperar que la ventana del navegador cargue completamente, revisar la sección Aplicaciones. En esta debe aparecer listada la aplicación GeoServer. Página 22 de 36

23 Abrir una ventana de navegador, acceder a la URL En esta se debe desplegar la página de inicio de GeoServer Autenticarse en esta página con las siguientes credenciales usuario: admin, contraseña: geoserver (estas viene de la configuración por defecto de GeoServer). Si la autenticación fue correcta, deben desplegarse ahora algunas opciones en el panel de la izquierda. Página 23 de 36

24 En el panel de opciones de GeoServer (izquierda) dentro del grupo Datos, seleccionar la opción Espacios de trabajo, en la página que se despliega seleccionar la opción Agregar un nuevo espacio de trabajo En la nueva página, ingresar en nombre: wmsgeoserver y en URI del espacio de nombres: dar click en el botón guardar Página 24 de 36

25 Ahora el espacio de trabajo creado debe aparecer en el listado A continuación se debe crear un nuevo almacén de datos seleccionando la opción Almacenes de datos del grupo Datos y dentro de la nueva ventana seleccionar la opción de Agregar nuevo almacén. Página 25 de 36

26 Dentro del grupo Orígenes de datos vectoriales seleccionar la opción Shapefile En la ventana Nuevo Origen de datos vectoriales, buscar la sección Información básica del almacén, e ingresar los siguientes valores: Espacio de trabajo: seleccionar wmsgeoserver de la lista desplegable Nombre del origen de datos: manzanas Descripción: agregar una breve descripción del conjunto de datos En la sección Parámetros de conexión se debe ingresar la ruta de acceso al shapefile que se desea publicar, para ello se debe seleccionar la opción Buscar... y navegar hasta la ubicación del archivo en la ventana de diálogo que se despliega, luego dar click en el botón Guardar. Página 26 de 36

27 Ahora se despliega una ventana llamada Nueva capa, en la cual debe aparecer listada la capa que ha sido agregada a nuestro almacén de datos, dar click en la opción Publicación. En la ventana Editar capa, ir a la sección Sistema de referencia de coordenadas y agregar los siguientes valores: SRS declarado: EPSG:4686 Encuadre Nativo: Min X:-74,0857 Min Y:4,6200 Max X:-74,0744 Max Y:4,6270 Encuadre Lat/Lon: Min X:-74,0857 Min Y:4,6200 Max X:-74,0744 Max Y:4,6270 Página 27 de 36

28 Dar click en el botón Guardar. Ahora la nueva capa debe aparecer en el listado de capas de GeoServer. Página 28 de 36

29 Seleccionar la opción Almacenes de datos del grupo Datos de la página de administración de GeoServer y dentro de la nueva ventana seleccionar la opción de Agregar nuevo almacén. Dentro del grupo Orígenes de datos raster seleccionar la opción GeoTIFF En la ventana Nuevo Origen de datos raster, buscar la sección Información básica del almacén, e ingresar los siguientes valores: Espacio de trabajo: seleccionar wmsgeoserver de la lista desplegable Nombre del origen de datos: mosaico2009 Descripción: agregar una breve descripción del conjunto de datos En la sección Parámetros de conexión se debe ingresar la ruta de acceso al archivo en formato raster que se desea publicar, para ello se debe seleccionar la opción Buscar... y navegar hasta la ubicación del archivo en la ventana de diálogo que se despliega, luego dar click en el botón Guardar. Página 29 de 36

30 Ahora se despliega una ventana llamada Nueva capa, en la cual debe aparecer listada la capa que ha sido agregada a nuestro almacén de datos, dar click en la opción Publicación. En la ventana Editar capa, ir a la sección Sistema de referencia de coordenadas y agregar los siguientes valores SRS declarado: EPSG:4686 Encuadre Nativo: Min X:-74,0857 Página 30 de 36

31 Encuadre Lat/Lon: Min Y:4,6200 Max X:-74,0744 Max Y:4,6270 Min X:-74,0857 Min Y:4,6200 Max X:-74,0744 Max Y:4,6270 Dar click en el botón Guardar. Ahora la nueva capa debe aparecer en el listado de capas de GeoServer. Página 31 de 36

32 Ir a la sección de previsualización de capas y una vez allí, buscar las capas que fueron agregadas a nuestro almacén de datos wmsgeoserver y en la columna de la derecha, de la sección WMS de la lista desplegable seleccionar un formato de imagen (GeoTiff, JPEG, PNG ). Se debe abrir una nueva ventana con una imagen de nuestros datos, la cual es resultado de una petición GetMap a nuestro almacén de datos. Página 32 de 36

33 También se puede probar el funcionamiento del servicio WMS enviando una petición GetMap válida mediante nuestro navegador. ej.: ap&layers=wmsgeoserver:mosaico2009,wmsgeoserver:manzanas&styles=&bbox= ,4.62, ,4.627&width=850&height=495&srs=EPSG:4686&format=image/png Página 33 de 36

34 Es un servidor HTTP y un contenedor de servlets. Como servidor HTTP es uno de los más ampliamente usados junto con Internet Information Server (IIS) de Microsoft. Como contenedor de servlets implementa las especificaciones Java Servlet y JavaServer Pages (JSP) de Oracle Corporation. Interfaz de entrada común (en inglés Common Gateway Interface, abreviado CGI) es una importante tecnología que permite a un cliente (navegador web) solicitar datos de un programa ejecutado en un servidor web. CGI especifica un estándar para transferir datos entre el cliente y el programa. Es un mecanismo de comunicación entre el servidor web y una aplicación externa cuyo resultado final de la ejecución son objetos MIME. Las aplicaciones que se ejecutan en el servidor reciben el nombre de CGIs. Las aplicaciones CGI fueron una de las primeras prácticas de crear contenido dinámico para las páginas web. En una aplicación CGI, el servidor web pasa las solicitudes del cliente a un programa externo. Este programa puede estar escrito en cualquier lenguaje que soporte el servidor, aunque por razones de portabilidad se suelen usar lenguajes de script. La salida de dicho programa es enviada al cliente en lugar del archivo estático tradicional. CGI ha hecho posible la implementación de funciones nuevas y variadas en las páginas web, de tal manera que esta interfaz rápidamente se volvió un estándar, siendo implementada en todo tipo de servidores web. Grupo de investigación fundado en 1986 conformado por geodestas, topógrafos, cartógrafos vinculados a compañías petroleras europeas. EPSG compiló y difundió el EPSG geodetic parameter dataset, un repositorio que contiene información de elipsoides, datums, sistemas de coordenadas, proyecciones cartográficas, que pueden ser utilizados para definir transformaciones y conversiones que permitan llevar unas coordenadas de un Sistema Coordenado de Referencia a otro. Las tareas previamente desempeñadas por la EPSG son ahora llevadas a cabo por la OGP (International Association of Oil and Gas Producers Surveying and Positioning Committee). Software Open Source escrito en Java que permite publicar y editar múltiples formatos de información geoespacial. Es un proyecto comunitario desarrollado y probado por un gran número de personas y organizaciones alrededor del mundo Página 34 de 36

35 Conjunto de elementos de software (librerías y una máquina virtual de Java) que pueden ser utilizados por un Sistema Operativo ejecutar una aplicación escrita en lenguaje Java Es el mecanismo básico de configuración del software MapServer. Se compone de objetos, cada uno de los cuales se compone variables de configuración y/o otros objetos (tiene una estructura jerárquica de manera tal que un objeto puede contener múltiples objetos). Todos los mapfiles deben comenzar con la declaración del objeto MAP, la declaración de todo objeto de un Mapfile debe terminar con la palabra. Los comentarios de un Mapfile son precedidos por el signo #. Software Open Source desarrollado en la década de los 90 s en la Universidad de Minnesota para publicar información geoespacial y aplicaciones interactivas de mapas en la red. Puede ser ejecutado en plataformas Windows, Linux, Mac OS X, Solaris. Mapserver puede ser integrado con componentes desarrollados en lenguajes como PHP, Python, Perl, Ruby, Java,.NET. Es un programa que, utilizando el modelo cliente servidor y el Protocolo de Transferencia de Hipertexto (HTTP), publica archivas que generan y retornan páginas Web a un usuario cuyo cliente ha enviado una petición al servidor. Archivo utilizado para distribuir el conjunto de páginas JSP, Servlets Java, Clases java, Archivos XMLy páginas Web estáticas que componen una aplicación Web. Página 35 de 36

36 Página 36 de 36