Introducción a los proyectos de mapas

Disponible desde la versión 5.0.0-Renegade

Interfaz de usuario: 6.1.1-Warcraft

Objetivos

Esta funcionalidad permite una completa gestión de proyectos de mapas GIS desde la propia Plataforma.

La funcionalidad incluye:

  • Configuración visual de los mapas: incluyendo las herramientas que se muestran, las capas, los servicios y los distintos estilos.

  • API REST: para poder controlar la funcionalidad desde otras aplicaciones, incluyendo la importación y exportación de estos proyectos.

  • Un proyecto web: de la Plataforma, que muestra el proyecto de mapas con la seguridad de la Plataforma.

Acceso a la funcionalidad

Control Panel

Para acceder a los proyectos de mapas, tendremos que haber iniciado sesión con una cuenta de tipo «administrador», «desarrollador» o «analista». Navegaremos al menú de Visualización > Gestión Proyectos Mapas.

image-20240823-094440.png

API REST

Para acceder al API REST correspondiente a los proyectos de mapas, en la cabecera del Control Panel, se abrirá el menú contextual (el de los tres puntos) y se seleccionará la opción de «APIs».

image-20240823-094742.png

Seguidamente, en el modal que aparecerá, se seleccionará la opción de «Panel de Control» en el apartado de APIs.

En el selector de Swagger, se seleccionará la opción de «Maps Project»:

El API de /api/mapsproject/import permite adjuntar un fichero JSON para importar un proyecto completo, con sus mapas, capas y estilos.

El API de /api/mapsproject/export devuelve el JSON con toda la información del proyecto a partir del identificador administrado

El API de /api/mapsproject/ da como respuesta el listado de proyectos a los que tiene acceso el usuario que realiza la consulta.

¿Cómo se usa la funcionalidad?

Elementos

La funcionalidad permite la gestión de los cuatro tipos de elementos manejados:

  • Proyecto de mapas: que contiene un listado ordenado de mapas.

  • Mapas: cada mapa incluye un listado de capas.

  • Capas: cada capa tiene un conjunto de estilos.

  • Estilos: las capas se pueden personalizar visualmente añadiéndoles estilos personalizados.

Accediendo a cada una de las opciones disponibles, se accederá primero a un listado desde el cual se va a poder gestionar cada elemento:

Opciones sobre proyectos

Importar

En el listado de proyectos de mapas existe un botón para importar proyectos

Se podrá importar un proyecto sobre un proyecto nuevo o existente, se seleccionará un fichero con la estructura JSON del proyecto , se introduce un identificador y se marca overwrite para que se sobre escriban los elementos que ya existen y se pulsa Confirm.

Clonar y exportar

En cada elemento del listado si pulsamos en el icono con tres puntos se muestra una modal con las opciones de clonar el proyecto o exportarlo.

La opción de «Clonar» permite clonar el proyecto y todos lo elementos que lo componen. La opción de «Clonar para usuarios» permite clonar el proyecto de mapas a usuarios en concreto (sólo disponible para un usuario con rol de «administrador»).

Creación de un proyecto de Mapas

A la hora de crear un proyecto de Mapas aparecerá un formulario con toda la configuración que se puede dar a un proyecto de mapas.

Para navegar entre las distintas secciones y herramientas se dispone de un listado en la parte izquierda donde ir clicando.

Desde aquí también se pueden crear mapas nuevos y añadirlos al proyecto

Desde el formulario se pueden seleccionar mapas y ordenarlos. Si se pulsa el icono del lápiz se abre una nueva pestaña en el navegador con la ventana de edición de ese mapa.

El funcionamiento es igual con los estilos en el proyecto

o con las capas o servicios en los mapas

De esta forma se mejora la experiencia de usuario al poder al no tener que ir realizando búsquedas en los listados principales de cada tipo de elemento.

Visualización de un proyecto de Mapas

Para visualizar un proyecto de mapas. desde el proyecto web se indica la url de la instalación de plataforma que se quiere utilizar así como el identificador del proyecto de mapas.

Mediante el API REST de proyectos de mapas se recupera la configuración del proyecto y la librería de mapas se ocupa de renderizar el proyecto.

Como siguientes pasos, se incluirá la visualización automática de los proyectos de mapas mediante un visor de mapas genérico.