Instalación de Geoserver

Esta guía asume que tienes acceso a datos de mapas en formato shapefile que deseas usar con GpsGate Server y VehicleTracker. Además de GpsGate Server, utilizaremos GeoServer y OpenLayers, ambos son de código abierto y gratuitos.

1. Verifica que tienes los datos Shapefile requeridos

Un shapefile es un conjunto de varios archivos. Además del archivo con la extensión .shp, los archivos .shx y .dbf también son necesarios para formar el triplete obligatorio que define un shapefile. También podrías tener una combinación de otros archivos opcionales que describen proyección, geocodificación, etc. GeoServer manejará automáticamente cualquier archivo opcional.

Los datos típicos de mapas se dividen en varias capas de archivos de forma. En esta guía asumiremos un caso típico de tres capas:

  • polígono.(shp/shx/dbf) = país, línea de costa.
  • línea.(shp/shx/dbf) = carreteras, ríos.
  • poi.(shp/shx/dbf) = Punto de interés. Es decir, clientes, hospitales, pubs y otros lugares importantes.

2. Instalar GeoServer

Descarga el instalador de GeoServer aquí. Ten en cuenta que esta publicación del blog fue escrita originalmente para la versión 2.0.2 de GeoServer y desde entonces se ha actualizado a la versión 2.24.2. La interfaz de usuario puede haber cambiado ligeramente, pero es prácticamente la misma que cuando se tomaron las capturas de pantalla originales.

En mi experiencia en Windows, la instalación fue muy sencilla, un instalador tipo asistente.
Cuando se te pregunte sobre el “Tipo de Instalación”, lo más probable es que desees seleccionar “Ejecutar como Servicio” para una configuración de producción.

Aparte del almacenamiento real de datos de mapas y el uso de ancho de banda, ten en cuenta que GeoServer también consumirá recursos de memoria y CPU, por lo que colócalo en una máquina con ciclos de sobra. Por defecto, los datos del mapa estarán ubicados en el directorio de instalación, pero también puedes especificar la ubicación del directorio de datos por separado.
En esta guía, asumiremos el directorio predeterminado.

3. Copia tus datos de archivos de forma al almacén de datos de GeoServer

Por defecto, el directorio de datos del mapa se encuentra en C:/ [ProgramFiles]/GeoServer/

Crea un nuevo subdirectorio (por ejemplo, “MiNuevoMapa”) y copia todos tus shapefiles allí.

4. Inicia sesión en GeoServer

Inicia tu navegador web favorito y ve a la página de inicio de sesión de GeoServer. La URL predeterminada es http://www.yourserver.com:8080/geoserver/web/, pero también está disponible como un enlace “GeoServer Web Admin Page” en el menú de inicio de Windows.

Consulta la guía de inicio rápido de GeoServer sobre cómo configurar cuentas de usuario, iniciar sesión, etc. En este tutorial solo requerimos la configuración predeterminada y el usuario predeterminado, por lo tanto, no necesitas cambiar nada.

Cuando hayas iniciado sesión, el lado izquierdo de la interfaz contiene el menú con las funcionalidades principales. En el resto de esta guía, haremos referencia a un cierto menú diciendo: Menú Raíz->Directorio->Función, ej: Datos->Estilos->Agregar nuevo Estilo.
En particular, todos los menús necesarios en esta guía se encuentran en el grupo “Datos”.

Ahora estamos listos para comenzar a crear el mapa real.

5. Crea un espacio de trabajo

Los espacios de trabajo se utilizan como una agrupación lógica de tus datos. Normalmente creas espacios de trabajo basados en el nombre de tu empresa y/o por proyecto.

Ir a: Datos->Espacios de trabajo->Agregar nuevo espacio de trabajo para crear un nuevo espacio de trabajo.

Aquí elegimos el nombre “MiEmpresa”.

new_workspace.jpg

Presiona el botón “Enviar”.

6. Importa tus shapefiles

Ahora podemos importar los shapefiles en el almacén de datos de GeoServer. Lo más fácil es importar todo el directorio de shapefiles de una vez, aunque también puedes importar archivos individuales.

Ir a: Datos->Almacenes->Agregar nuevo Almacén.
Selecciona “Directorio de archivos espaciales"

new_vector_data_source.jpg

Selecciona tu espacio de trabajo, en este caso, “MiEmpresa”, y luego dale un nombre a tus datos. Aquí elegimos “MiNuevoMapa”.

Apunta a tus datos de shapefile en el disco

En “Parámetros de Conexión” establece la URL a file:data/MiNuevoMapa, donde “MiNuevoMapa” se refiere al directorio donde colocaste tus archivos de datos de mapa en el paso 3.

Presiona el botón “Guardar”.

7. Crea capas de mapa

Ahora necesitamos convertir los datos de forma en bruto en capas de mapa.

Ir a: Datos->Capas->Agregar un nuevo recurso para crear una nueva capa.
Elige tu almacén de datos en la lista desplegable. En este ejemplo, será “MiEmpresa:MiNuevoMapa”.
Ahora deberías ver las capas disponibles correspondientes a tus shapefiles.

new_layer_chooser.jpg

A continuación, las capas necesitan ser configuradas y “publicadas”. Haz clic en “Publicar” en el lado derecho.


7.1 Especificar Sistemas de Referencia de Coordenadas, SRS

Haz clic en “Buscar” para ver si el sistema de coordenadas ya está incluido en tus archivos de datos. De lo contrario, el sistema de coordenadas más común probablemente sea EPSG:4326 (Igual que WGS84)
Agrégalo manualmente en ese caso escribiendo “EPSG:4326” en el campo “SRS Declarado”.


7.2 Especificar Cajas Delimitadoras

Las Cajas Delimitadoras describen la extensión de tu mapa (ya que tu mapa probablemente no cubra todo el globo).

Lo más fácil es hacer clic en “Calcular desde datos” y “Calcular desde límites nativos” respectivamente para generar cajas delimitadoras (si no tienes razones particulares para configuraciones personalizadas).

set_coord_system_cropped_2.jpg

Presiona el botón “Guardar”.

¡Repite los pasos anteriores (desde “Publicar”) para todas tus capas!


Cuando hayas terminado deberías poder ver tus capas en la lista algo así:

all_layers_list.jpg

8. Estiliza tus capas

Ahora necesitas especificar el aspecto de tus capas, coloración, ancho de diferentes caminos, etc.

Ve a la capa (como en el paso 7) y selecciona la pestaña “Publicación” en la parte superior.

set_layer_style_cropped.jpg

En “Configuraciones WMS”, elige por ejemplo uno de los estilos predeterminados en el menú desplegable.
Consejo: Consulta a tu “experto en páginas web” si necesitas un estilo más avanzado.


Presiona el botón “Guardar”.

¡Repite este paso para las capas restantes!


Nota: El color de fondo del mapa por alguna razón no puede configurarse aquí, se especifica en la configuración de OpenLayers (más sobre esto en el paso 11).

Nota: Este estilo será el predeterminado para la capa, pero también puedes asociar un estilo separado con tu capa al crear el “Grupo de capas” en el siguiente paso.

9. Agrupa tus capas en un mapa

Ahora necesitamos especificar que nuestras capas están destinadas a ser agrupadas en un mapa.

Ve a: Datos -> Grupos de capas -> Agregar nuevo grupo de capas para crear un nuevo grupo. Aquí lo llamamos “MiNuevoMapa”.


Agrega tus capas al grupo
Haz clic en “Agregar capa” y selecciona cada una de tus capas.

Cuando hayas agregado todas tus capas, haz clic en “Generar límites” (los límites serán la unión de los límites de las capas individuales como establecimos en el paso 7).


Verifica el orden de las capas

Aquí indicamos qué orden visible tendrán nuestras capas.

La capa inferior será la primera en la lista, la siguiente capa quedará encima (cubriendo la anterior).
En nuestro caso de ejemplo, esto significa que el orden correcto debería ser:
- polígono (suelo).
- línea (carreteras).
- poi (clientes).

Haz clic en las flechas verdes hacia arriba/abajo en cada capa para cambiar el orden.

Presiona el botón “Guardar”.

10. Verifica que el mapa se vea bien en la Demo/previa

.. ¡Casi terminado!

Ve a: Previsualización de capas (al final en el menú de la izquierda).
Aquí ahora deberías poder ver tus capas separadas, “MiEmpresa:línea”, “MiEmpresa:poi”, “MiEmpresa:polígono” y lo más importante, el mapa resultante: “MiNuevoMapa”

all_layers_preview.jpg

¡Ahora simplemente haz clic en “OpenLayers” para ver el resultado de tu arduo trabajo!

Si el mapa no se ve como te gustaría, necesitas volver y ajustar el estilo (en Datos->Estilos). No hace falta decir que, si el mapa no se muestra correctamente aquí, ¡tampoco se mostrará correctamente en VehicleTracker!

Mantén esta ventana de previsualización abierta, se necesitará en el siguiente paso.

11. Instala los plugins CoreMap y GeoServer del Servidor GpsGate para cargar tu mapa

Ahora podemos comenzar la fase final de importación del mapa al Servidor GpsGate y VehicleTracker usando plugins de mapas OpenLayers.

Desde SiteAdmin -> Plugins -> Obtener más plugins, primero instala CoreMap, y luego instala el plugin llamado GeoServer.

Ahora puedes configurar un mapa GeoServer en GpsGate desde la página SiteAdmin -> Mapas -> GeoServer.

En esa página, puedes configurar ajustes como la URL WMS, color de fondo, maxResolution (afecta la escala del mapa), y otros ajustes que deben ser específicamente ajustados para el grupo de capas que has creado en GeoServer.

Afortunadamente, puedes encontrar valores adecuados para estos ajustes previsualizando tu capa desde la página de administración web de GeoServer. Ve a Previsualización de capas (como en el paso 10) en la página de administración web de GeoServer y selecciona tu “MiNuevoMapa”, luego selecciona “ver código fuente” en tu navegador web.

Aquí tienes un fragmento de ejemplo de las partes relevantes del código fuente de la previsualización que deberías ver.
(debería comenzar alrededor de la línea #130 en la ventana “ver código fuente”).

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
....
 
var options = {
    controls: [],
    maxExtent: bounds,
    maxResolution: 0.01869921875, // (1)
    projection: "EPSG:4326", // (2)
    units: 'degrees'
};
 
var map = new OpenLayers.Map('map', options);
 
// configurar capa en mosaico
var tiled = new OpenLayers.Layer.WMS(
    "Capas de Geoserver - Mosaico", "http://yourserver.com/geoserver/MyCompany/wms", // (3) la URL apuntará a su GeoServer
    {
        height: '123',
        width: '123',
        layers: 'MyNewMap', // (4)
        styles: '',
        srs: 'EPSG:4326',
        format: format,
        tiled: 'true',
        bgColor: '0xECD0D5', // (5) color de fondo en formato 0xRRGGBB
        tilesOrigin : map.maxExtent.left + ',' + map.maxExtent.bottom
    },
    {
        buffer: 0,
        displayOutsideMaxExtent: true
    }
);
....

Puedes leer más sobre la configuración de capas WMS de OpenLayers aquí.


11.1 Crear un mapa en GpsGate SiteAdmin copiando la configuración del mapa desde GeoServer

Ahora debemos crear un mapa de GeoServer en GpsGate  Administración del sitio (legacy) copiando los parámetros necesarios del mapa de ejemplo de GeoServer.

- Ve a  Administración del sitio (legacy) -> Mapas -> GeoServer
- Haz clic en “Crear nuevo”

edit_geoserver_map.png
- Busca la configuración relevante indicada en el fragmento anterior con (1)(2), etc.
- Ingresa el valor en el campo de entrada correspondiente en el formulario de SiteAdmin.
- Cuando termines, haz clic en Guardar.


Finalmente, para habilitar el mapa de GeoServer para una aplicación, ve a Administración del sitio › Aplicaciones › Administrar aplicaciones - haz clic en la aplicación.

2. Navega a Mapas y Geocodificadores donde seleccionas el mapa de GeoServer 

Screenshot 2024-02-28 at 16.13.50.png

3. Haz clic en “Guardar”

13. ¡Terminado!

Inicia VehicleTracker, ve al menú “Mapas” y selecciona “GeoServer”. Voilà - ¡ahora puedes comenzar a rastrear en tu propio mapa completamente nuevo!

Screenshot 2024-02-28 at 16.15.45.png
Ten en cuenta que si configuras muchos mapas de GeoServer, puedes seleccionar uno de ellos haciendo clic en el signo más azul y blanco en el borde superior derecho de la vista del mapa.