El proyecto sisdai-mapas es una biblioteca de visualización de datos geográficos que forma parte del Sistema de Diseño y Accesibilidad para la Investigación (Sisdai).
Cualquier persona puede hacer uso de esta biblioteca al clonarla e instalarla en su equipo a través del protocolo HTTPS.
- Homologa los estilos utilizando el sistema de diseño Sisdai.
- Mejora la accesibilidad mediante el uso de html semántico y aplicando las reglas establecidas en Sisdai.
- Facilita la actualización de elementos institucionales requeridos.
- Facilita y reduce el código de elementos para la visualización de datos geográficos.
En la carpeta principal de tu proyecto Vue, instala la biblioteca en las dependencias de tu proyecto con:
npm install git+https://codigo.conahcyt.mx/sisdai/sisdai-mapasDependiendo de la versión de la biblioteca a instalar, las instrucción anterior puede cambiar a:
npm install git+https://codigo.conahcyt.mx/sisdai/sisdai-mapas#vN.N.Ndonde N.N.N indica el número de versión, por ejemplo v1.0.0
En el archivo main.js de tu proyecto Vue, importa la biblioteca con:
// src/main.js
import SisdaiMapas from 'sisdai-mapas'
Vue.use(SisdaiMapas)En cualquier vista en la sección <template> de tu proyecto puedes utilizar el componente de mapa
sin necesidad de volver a importarlo en el script. Por ejemplo:
<template>
<SisdaiMapa>
<SisdaiCapaXyz />
</SisdaiMapa>
</template>Para un uso avanzado revisa la documentación.
Si actualmente utilizas la biblioteca y necesitas utilizar otra versión de los mapas, en la carpeta del proyecto instala la versión que requieres nuevamente
npm install git+https://codigo.conahcyt.mx/sisdai/sisdai-mapas#vN.N.Ndonde N.N.N indica el número de versión, por ejemplo v1.0.0
El componente SisdaiMapa es un contenedor especial único que alberga todos los elementos opcionales y requeridos para un mapa interactivo con datos georeferenciados
| Elemento | Descripción |
|---|---|
| SisdaiCapaGeojson | Las capas vectoriales en geojson nos permiten manipular su información de forma local, esto nos da la posibilidad de pintar sus elementos de forma interactiva, incluso de clasificarlos |
| SisdaiCapaXyz | La capa de mosaicos xyz, consume servicios que dentro de la url incluyen el nivel de zoom y la coordenada x/y de una imagen (mosaico) |
| SisdaiCapaWms | Componente para desplegar capas desde servicios Web Map Service (WMS) públicos o privados. |
| SisdaiMapaLeyenda | Componente de leyenda interactiva vinculada con una capa del mapa |
Para desarrollar este proyecto se usa node.js como entorno de ejecución de JavaScript. La opción recomendada para instalarlo es vía nvm que es el manejador de versiones de node. Siguiendo este camino, también se instalará el manejador de paquetes npm. Las instrucciones de instalación y dependencias del proyecto se muestran aquí usando tanto npm, como nvm.
Se puede clonar e instalar este proyecto en tu equipo utilizando solo el protocolo HTTPS, es decir:
git clone https://codigo.conahcyt.mx/sisdai/sisdai-mapas.gitEstablece la versión adecuada de npm y nvm (previamente instaladas).
nvm use 18Instala las dependencias de la biblioteca.
npm installEste proyecto cuenta con una documentación más extensa que aún está en proceso de desarrollo. Es posible levantarla en un ambiente local con la instrucción:
npm run docsSOFTWARE LIBRE Y ESTÁNDARES ABIERTOS
Sisdai y sisdai-mapas están alineadas a las disposiciones establecidas por la Coordinación de Estrategia Digital Nacional ( DOF:06/09/2021) en donde se estipula que las "políticas y disposiciones tienen como objetivo fortalecer el uso del software libre y los estándares abiertos, fomentar el desarrollo de aplicaciones institucionales con utilidad pública, lograr la autonomía, soberanía e independencia tecnológicas dentro de la APF". En el artículo 63 se explicita que "cuando se trate de desarrollos basados en software libre, se respetarán las condiciones de su licenciamiento original [...]".
Considerando lo anterior, sisdai-mapas se publica bajo la licencia LGPLv3. Dicha licencia se puede consultar en el archivo LICENSE de este repositorio. Esta licencia se encuentra disponible en inglés porque aunque el Sisdai privilegia el idioma español se respeta la versión original de acuerdo al proyecto GNU.
Por el momento sólo quienes sean parte de un equipo de investigación del capítulo de un ENI podrán levantar issues en este repositorio. El equipo del Sisdai se encargará de mantenerlo.