Geoportal Costa Rica

Manual de usuario de Isocarta

Isocarta une iso- («igual», como en isolíneas) y carta («mapa»). Es un geoportal libre: una plataforma web para encontrar, ver, analizar, editar y compartir información geográfica. Este manual explica qué es un geoportal y cómo se usa cada función. También cuenta cómo enviar sugerencias y cómo crear plugins propios, ya sea para compartirlos como código libre o para comercializarlos.

Video narrado y subtitulado: recorrido por Isocarta, de qué es un geoportal a cómo crear un plugin con ayuda de la IA. Transcripción: video.vtt.

Video 2, para empezar de cero (5 min): cómo crear una institución y sus cuentas, subir un archivo CSV, hacer un mapa web, publicarlo para todo el mundo o sólo para las cuentas de su institución, y armar un subsitio con sus tarjetas. Ejemplo de demostración con el Ministerio de Educación de El Salvador, grabado en una copia de prueba. Transcripción: video_publicar.vtt.

1. ¿Qué es un geoportal?

Un geoportal es la puerta de entrada, en internet, a la información geográfica de un país, una región o una organización. Reúne en un solo sitio datos que suelen estar dispersos, por ejemplo:

Con un geoportal, esos datos se pueden ver juntos sobre un mapa.

Un geoportal no es sólo un visor de mapas. También sirve para:

Los geoportales son el corazón de una Infraestructura de Datos Espaciales (IDE). Esa es la red de instituciones, normas y servicios que permite que la información geográfica pública se encuentre, se comparta y se reutilice.

2. Isocarta y su ejemplo con datos libres de Panamá

Isocarta se publica con un ejemplo de datos libres de Panamá, para probar todas sus funciones sin configurar nada. Son capas abiertas, simplificadas para verlas con fluidez en el navegador. Cada una conserva su fuente y su licencia en la ficha y en la leyenda.

Tema Capas Fuente Licencia
Límites Provincias y comarcas (13), distritos (76), corregimientos (594) INEC / IGNTG, publicado por OCHA (HDX) CC BY-IGO
Hidrografía Ríos principales (504) WWF / HydroSHEDS uso libre con atribución
Transporte Vías principales (6 878) colaboradores de OpenStreetMap (Geofabrik) ODbL 1.0
Ambiente Áreas protegidas, SINAP 2025 (93) Ministerio de Ambiente (MiAMBIENTE) servicio público; licencia no declarada
Servicios esenciales Establecimientos de salud (1 055), centros educativos (2 728) Healthsites, HOT, a partir de OpenStreetMap ODbL 1.0
Sismo de Azuero 2026 Epicentro M7.7, réplicas, ShakeMap (MMI y PGA), plano de ruptura Servicio Geológico de EE. UU. (USGS) dominio público
Amenazas Fallas activas (74), sismos históricos M ≥ 6 (154) GEM Foundation; USGS CC BY-SA 4.0; dominio público

El ejemplo gira en torno al sismo de Azuero del 9 de octubre de 2026: epicentro, réplicas, intensidades y fallas, junto a la población, las escuelas y los centros de salud. Así muestra para qué sirve un geoportal ante una emergencia.

En el sitio de demostración se entra con una cuenta. Las cuentas, la bitácora de auditoría, las extensiones y las capas que usted suba se guardan en su navegador: otro navegador no las ve.

3. La pantalla

La pantalla de Isocarta: menús a la izquierda, el mapa al centro y los paneles a la derecha

La pantalla de Isocarta: menús a la izquierda, el mapa al centro y los paneles a la derecha

Ayuda contextual. Junto a cada opción del menú hay un botón ?. Explica para qué sirve la función y en qué menú está, y ofrece cuatro acciones: abrirla, mostrarla en la interfaz, recorrer el árbol de decisiones (qué necesita antes y qué habilita después) y reportar un error o sugerir una mejora sobre esa función.

La ayuda contextual del catálogo, con el acceso directo para reportar un error o sugerir una mejora

La ayuda contextual del catálogo, con el acceso directo para reportar un error o sugerir una mejora

4. Cómo comunicar sugerencias, mejoras o errores

Isocarta mejora con lo que proponen quienes lo usan. Hay dos caminos:

  1. Menú Ayuda → Sugerencias y errores.
  2. Desde el botón ? de cualquier función, con Reportar un error o sugerir una mejora. El formulario se abre con esa función ya elegida.

El formulario distingue tres tipos de envío:

Tipo Qué se pide
Función nueva en qué menú la ubicaría, cómo la llamaría, qué hace y para quién, y un boceto: una foto de un dibujo en papel, una captura o un dibujo hecho ahí mismo
Mejora la función que se mejora y qué cambiaría
Error qué pasó, qué esperaba y los pasos para reproducirlo; puede adjuntar datos técnicos (navegador, pantalla y últimos errores de la página)
Propuesta de una función nueva, con su boceto dibujado en el propio formulario

Propuesta de una función nueva, con su boceto dibujado en el propio formulario

Si la propuesta se aprueba, usted elige qué autoría se consigna: su nombre, su empresa u organización, su equipo, o ninguna. También elige cómo se desarrolla:

La modalidad «Extensión propia», con la dirección donde se adquiere

La modalidad «Extensión propia», con la dirección donde se adquiere

En Recibidas, un administrador o publicador da seguimiento a cada envío (Recibida, En estudio, Aprobada, En desarrollo, Resuelta o Descartada), con notas. Cada envío se puede copiar como texto o descargar en JSON para hacerlo llegar al equipo.

5. Las funciones, una por una

5.1 Menú Datos

Catálogo de datos. Arriba están las capas activas (las que están en el mapa, con sus controles; ver Capas activas en el menú Mapa). Debajo, las demás capas por tema, con su tipo de geometría, el número de elementos y la fuente. El interruptor activa la capa en el mapa —pasa entonces a las capas activas— y el botón ⓘ abre su ficha de metadatos. Las capas que se encienden desde Servicios OGC externos, Conectar base PostGIS o Elevación (DEM), y las derivadas de un DEM, se agregan al catálogo (grupos «Servicios OGC externos», «PostGIS» y «Elevación y derivadas») y siguen ahí aunque se quiten del mapa, también al volver a entrar. El botón ✕ las saca del catálogo.

El catálogo de datos

El catálogo de datos

Buscar capas. Filtra el catálogo por palabras: título, institución o tema.

Búsqueda de capas con la palabra «sismo»

Búsqueda de capas con la palabra «sismo»

Subir capa. Arrastre sus archivos o elíjalos. Acepta GeoJSON, Shapefile (.zip o .shp + .dbf + .prj), GeoPackage, KML/KMZ, GPX y CSV, y también ráster: GeoTIFF y ASCII Grid.

Una capa propia recién subida

Una capa propia recién subida

Elevación (DEM). Carga, para la zona que muestra el mapa, un modelo digital de elevación (DEM) global y gratuito. Se nombra con su cuadrante de 1° (como las teselas: N08 W081) y el lugar más céntrico de la zona, por ejemplo «GLO-30 · N08 W081 · Santiago», y queda en el Catálogo de datos, grupo «Elevación y derivadas».

Derivadas del DEM. Con el botón de montaña de un DEM en el Catálogo de datos se generan sus derivadas: curvas de nivel, sombreado, pendiente (%) y orientación (°). Fuentes de DEM disponibles:

Fuente Píxel Exactitud vertical (LE90)
Copernicus DEM GLO-30 30 m < 4 m
Copernicus DEM GLO-90 90 m < 4 m
ALOS AW3D30 (JAXA) 30 m ≈ 5 m
SRTM GL1 (NASA) 30 m ≈ 9 m

Los modelos globales son de superficie (DSM): en bosques y ciudades miden la copa de los árboles o los techos, no el suelo. Para obras de detalle use un DEM de terreno (LiDAR).

Curvas de nivel cada 20 m sobre el Copernicus DEM GLO-30 en Boquete, con su intervalo recomendado

Curvas de nivel cada 20 m sobre el Copernicus DEM GLO-30 en Boquete, con su intervalo recomendado

Conectar base PostGIS. Muestra como capas vivas las tablas de una base PostgreSQL/PostGIS, a través de un servicio OGC API Features de sólo lectura (pg_featureserv). Sólo se ven las tablas que ese servicio autoriza.

Conexión a PostGIS

Conexión a PostGIS

Servicios OGC externos. Conecta servicios WMS u OGC API Features de otras instituciones (por ejemplo, las imágenes satelitales de NASA GIBS) y los muestra junto a las capas propias. El servidor externo tiene que permitir CORS.

Servicios OGC externos

Servicios OGC externos

Consultas SQL. Consultas espaciales en SQL (PostGIS) sobre las capas del catálogo y las suyas. Se ejecutan en una base que corre en su propio navegador, o en una base real a través de la pasarela de la plataforma. Los resultados con geometría se agregan al mapa. Es una extensión: se instala desde el panel Extensiones.

La extensión Consultas SQL

La extensión Consultas SQL

5.2 Menú Mapa

Capas activas. Las capas que están en el mapa, en la parte superior del Catálogo de datos (este comando abre el catálogo). Para cada una puede:

Capas activas

Capas activas

Simbología. Tematiza una capa, como en QGIS o GeoServer.

El estilo se exporta e importa como SLD (para GeoServer y GeoNode) y como QML (para QGIS), y queda guardado.

Provincias y comarcas por categorías del campo «nombre»

Provincias y comarcas por categorías del campo «nombre»

Leyenda. La simbología de las capas visibles, con la fuente y la licencia de cada una.

Leyenda

Leyenda

Mapas base. El fondo del mapa: claro, calles, Liberty, oscuro, fiordo, OpenStreetMap o satélite. Desde aquí también se activan el sombreado del relieve, la vista 3D y el globo.

Mapa base de satélite

Mapa base de satélite

Vista 2D / 3D. El terreno con relieve real, inclinación y edificios extruidos. Acérquese a una ciudad para verlos.

Vista 3D de la ciudad de Panamá

Vista 3D de la ciudad de Panamá

Vista de globo. Proyecta el mapa sobre un globo para ver Panamá en su contexto regional.

Vista de globo

Vista de globo

Medir distancia y Medir área. Haga clic en el mapa para añadir vértices y doble clic para terminar. El cálculo es geodésico, sobre el elipsoide WGS 84: la distancia en metros o kilómetros, y el área en hectáreas y km² con su perímetro. Deshacer quita el último vértice.

Medición de una distancia

Medición de una distancia

Medición de un área

Medición de un área

Buscar lugar. Busca poblados, direcciones y accidentes geográficos en el servicio Nominatim de OpenStreetMap, y lleva el mapa al resultado.

Búsqueda de «Boquete»

Búsqueda de «Boquete»

Coordenadas. La posición del cursor y del centro del mapa en grados, en grados-minutos-segundos y en UTM 17N. También lleva el mapa a unas coordenadas que usted escriba.

Coordenadas

Coordenadas

5.3 Menú Editar

Dibujar. Crea puntos, líneas y polígonos en la capa Borrador. Cada elemento queda como una versión en el Historial y se puede exportar en GeoJSON o enviar a revisión para publicarlo.

Un polígono dibujado

Un polígono dibujado

Editar vértices. Mueve, añade o elimina vértices de sus capas: las subidas o las dibujadas. Puede ajustar los vértices a otras capas con una tolerancia en píxeles. Las capas publicadas no se editan aquí.

Edición de vértices

Edición de vértices

Tabla de atributos. Los atributos de cualquier capa activa, con un renglón por elemento. Desde un renglón puede acercar el mapa a ese elemento.

Tabla de atributos de las provincias

Tabla de atributos de las provincias

Historial (git). Cada capa subida y cada elemento dibujado quedan como un commit, con la huella SHA-256 de su contenido. El historial muestra quién cambió qué y cuándo. Restaurar una versión crea un commit nuevo, y un publicador aprueba la versión antes de publicarla.

Historial de cambios

Historial de cambios

5.4 Menú Publicar

Mapa web. Convierte la vista actual (capas, leyenda y tema) en un mapa web, con cinco plantillas:

Copiar enlace guarda el mapa comprimido en la propia dirección, así que se abre sin servidor y sin cuenta. Con el servidor del geoportal, el enlace es corto (#m=…) y queda registrado en Publicado. Descargar HTML da una página para publicar en cualquier servidor web.

Publicar un mapa web

Publicar un mapa web

Publicado. Los mapas que usted publicó con enlace corto, con sus visitas y quién puede verlos: cualquiera con el enlace, cualquier cuenta del portal, o sólo las instituciones y cuentas que elija. El botón A mi sitio lleva cualquiera de ellos a su subsitio.

Mi sitio (subsitio de publicaciones). Una página pública propia, con una tarjeta por cada publicación, como la portada de los territorios indígenas en geociencias.net/territorios. Necesita el servidor del geoportal, que guarda los sitios y sus tarjetas. Funciona así:

1. Un administrador asigna el sitio. En Publicar → Mi sitio, el administrador de la institución (o el superadministrador) escribe el nombre del sitio y elige la cuenta dueña. El nombre va en la dirección: www.geociencias.net/cartografia/. Lleva de 2 a 40 letras sin tilde, números o guiones, y no puede ser una carpeta del geoportal (como territorios u ogc). Una cuenta puede tener varios sitios.

El administrador asigna un subsitio a una cuenta

El administrador asigna un subsitio a una cuenta

2. Al publicar, se agrega la tarjeta. Después de Copiar enlace en Mapa web, el botón Agregar a mi sitio abre la tarjeta ya llena: el título del mapa, su descripción y una miniatura tomada del mapa en pantalla. La miniatura se puede cambiar por otra imagen o quitar; sin ella, la tarjeta muestra la inicial del título sobre su color. Sirve para las cinco plantillas.

Agregar a mi sitio, al publicar un mapa web

Agregar a mi sitio, al publicar un mapa web

3. En Mi sitio se arma la portada. Ahí están la dirección pública y sus visitas; el título, la presentación, el pie con la autoría y el color del sitio; y la lista de tarjetas, que se ordenan con las flechas, se editan o se quitan. Agregar a mano pone una tarjeta con cualquier otra dirección (un informe, otra página). Quitar una tarjeta no borra el mapa: sigue en Publicado. Con Público apagado, el sitio deja de verse.

Mi sitio: portada y tarjetas

Mi sitio: portada y tarjetas

4. La página pública. Cualquiera la abre, sin cuenta. Cada tarjeta lleva su miniatura, el tipo de publicación (Infografía, Relato, Panel de capas, Lámina o Mapa interactivo), la descripción y la fecha, y abre la publicación. Si una publicación es restringida, pide entrar con una cuenta autorizada. Descargar el sitio (HTML) da una copia en un solo archivo, con las miniaturas dentro, para alojarla en otro servidor.

La página pública del subsitio

La página pública del subsitio

Las capturas de Mi sitio son de la instalación con datos de Costa Rica (www.geociencias.net), que tiene el servidor con base de datos; la demostración estática con datos de Panamá no lo tiene.

Servicio OGC. Publica las capas como servicio OGC API – Features, que abren QGIS (Capa → Añadir capa WFS / OGC API – Features) y GDAL (ogrinfo OAPIF:…). En la edición con servidor, GeoServer las sirve además como WMS y WFS, con filtros y permisos.

Servicio OGC

Servicio OGC

Compartir. Un enlace a la vista actual y el código para incrustarla en otra página.

Compartir

Compartir

5.5 Menú Extensiones

Las extensiones (plugins) son paquetes firmados .ipdeplug. El menú tiene tres opciones:

Extensiones instaladas. Las que ya están en la plataforma. El administrador las habilita, las deshabilita o las quita; cualquiera puede abrir las habilitadas. De cada una se ven sus permisos, su licencia, su precio y el enlace al sitio del editor.

Catálogo de extensiones. Las que se pueden instalar, agrupadas por fuente, con un buscador. Cada una dice si es nueva, si ya está instalada o si hay una versión más reciente (Actualizar).

Panel Extensiones con el catálogo

Panel Extensiones con el catálogo

¿Cómo crear un plugin propio? Abre, dentro de la propia interfaz, la guía para desarrolladores y la descarga del SDK. La sección 6 lo explica en detalle.

La guía para crear un plugin propio

La guía para crear un plugin propio

5.6 Menú Administrar

Usuarios y roles. Las cuentas, agrupadas por institución. Hay cinco roles: superadministrador, administrador, publicador, editor y lector.

Usuarios y roles

Usuarios y roles

Permisos por rol. Una tabla de casillas con las funciones del menú y los cinco roles. Lo que un rol no puede usar desaparece de su menú y de sus barras, y su panel no se abre. Sólo el superadministrador la cambia, y no puede quitarse a sí mismo Usuarios y roles ni Permisos por rol. Restablecer vuelve a los permisos de partida:

Permisos por rol

Permisos por rol

Auditoría. Una bitácora encadenada: cada evento lleva la huella del anterior, así que una alteración se detecta.

Auditoría

Auditoría

Seguridad. Un tablero que comprueba la configuración (conexión cifrada, cabeceras, contraseñas, doble factor, bloqueo, caducidad de sesión, auditoría, extensiones) y dice qué está bien y qué conviene revisar. Fija la política, por ejemplo exigir doble factor a los administradores.

Seguridad

Seguridad

Temas visuales. Cuatro temas listos (Papel, Grafito, Aurora y Canal), o uno propio: colores, tipografía, esquinas, densidad y mapa base. Comprueba el contraste para que el tema sea accesible y se exporta en JSON.

Temas visuales

Temas visuales

Información legal del sitio. Cada sitio que use el geoportal debe identificar a su titular y explicar qué hace con los datos de las personas. Este formulario llega prellenado:

Basta con completar el titular: nombre o razón social, identificación (cédula jurídica, RUC, NIF…), domicilio, correo y, si es una empresa, su inscripción registral. El panel dice cuántos datos faltan y hace una revisión de cumplimiento: aviso legal, privacidad, cookies, términos, comercio, accesibilidad (idioma, enlace para saltar al contenido, textos alternativos, contraste del tema), patrones oscuros, licencias, seguridad (HTTPS, contraseñas, contacto para vulnerabilidades), contenido de usuarios, publicidad y menores. Lo que puede comprobarse desde la página se comprueba solo.

Los textos son plantillas que se adaptan a cada sitio. Antes de publicarlos, hágalos revisar por asesoría legal.

Información legal del sitio: datos del titular y revisión de cumplimiento

Información legal del sitio: datos del titular y revisión de cumplimiento

Disposición. Reorganiza la interfaz arrastrando:

Cada disposición se guarda con un nombre, se restablece o se exporta.

Disposición

Disposición

5.7 Menú Ayuda

Acerca de

Acerca de

El botón Manual en la portada pública

El botón Manual en la portada pública

La política de privacidad, abierta sin iniciar sesión

La política de privacidad, abierta sin iniciar sesión

La primera vez, un aviso al pie explica qué guarda el sitio en su navegador. Este geoportal no usa cookies de publicidad ni de analítica. Si un sitio las agrega, el aviso le pide permiso antes y puede cambiar su elección en Información legal → Cookies.

6. ¿Qué es un plugin?

Un plugin (o extensión) es un complemento que añade una función a Isocarta sin tocar su núcleo. Por ejemplo:

En Isocarta, un plugin es un paquete .ipdeplug que lleva:

La plataforma lo verifica antes de instalarlo y lo ejecuta aislado: un plugin no ve la sesión ni los datos que no pidió.

Usted decide cómo distribuirlo. Al empaquetarlo, elige en [distribucion]:

Modo Para qué Qué hace Isocarta
Código libre en el catálogo compartirlo con todos, con una licencia libre (MIT, Apache-2.0, GPL…) lo anuncia en el catálogo de extensiones y, si es gratuito, puede alojarlo para instalarlo con un clic
Comercial venderlo o cobrar su uso (pago, suscripcion), con licencia propietaria lo anuncia, si usted quiere, con el botón Adquirir que lleva a su tienda o su sitio; la venta ocurre allí
Privado uso interno de su organización o de un cliente sólo verifica la firma al instalarlo

El código y los derechos de un plugin son de quien lo desarrolla. La licencia de Isocarta no obliga a abrir el código de un plugin: sólo obliga a compartir los cambios que se hagan al núcleo (ver la sección 9).

Descargar el SDK. El kit de desarrollo (SDK) está en Extensiones → ¿Cómo crear un plugin propio? → Descargar el SDK. Es un solo programa en Python, ipdeplug.py, con la guía completa. Con él puede:

python ipdeplug.py crear mi_plugin --plantilla capas    crea el proyecto desde una plantilla
python ipdeplug.py probar mi_plugin                     lo prueba sin firmar en un banco de pruebas
python ipdeplug.py editor-solicitar --id ... --nombre "..."   pide su certificado de editor (una sola vez)
python ipdeplug.py empaquetar mi_plugin --editor ...    lo firma y crea el .ipdeplug
python ipdeplug.py verificar mi_plugin-1.0.0.ipdeplug   lo comprueba como lo hará la plataforma
El banco de pruebas del SDK: el plugin funciona sin firmar, con capas de ejemplo y el registro de mensajes

El banco de pruebas del SDK: el plugin funciona sin firmar, con capas de ejemplo y el registro de mensajes

Su clave privada de editor nunca sale de su equipo: la plataforma sólo recibe su clave pública y le devuelve un certificado.

Las secciones 6.1 a 6.9 son la referencia técnica para quien escribe el plugin: el manifiesto, los mensajes con el mapa, la firma y la verificación.

6.1 Requisitos y proyecto

Todas las órdenes tienen ayuda: python ipdeplug.py --help o python ipdeplug.py ORDEN --help.

crear tiene dos plantillas: pagina, el mínimo, centra el mapa en unas coordenadas; capas lee una capa, calcula sus centroides, los añade al mapa y los descarga en CSV, y usa los cuatro permisos. El proyecto queda así:

mi_plugin/                 abra esta carpeta en VS Code (code mi_plugin)
  AGENTS.md                reglas del puente para asistentes de IA; CLAUDE.md la importa
  CLAUDE.md
  .vscode/extensions.json  extensiones recomendadas del editor
  .gitignore               deja fuera la clave del editor y los paquetes generados
  LEEME.md
  paquete/                 lo único que se firma y se distribuye
    extension.toml         el manifiesto
    web/index.html         la página que se abre en el geoportal

En paquete/ va sólo lo que irá en el paquete: la firma cubre cada archivo y la verificación rechaza cualquier archivo añadido después. empaquetar se niega a firmar si encuentra ahí .git, __pycache__, node_modules o archivos del sistema. El control de versiones (git) va en la carpeta del proyecto.

6.2 El manifiesto extension.toml

id = "mi_plugin"             # letras, números, - y _; no se puede cambiar después
nombre = "Mi plugin"
version = "1.0.0"             # X.Y.Z; súbala en cada entrega
descripcion = "Qué hace, en una frase."
editor = "su_id_de_editor"    # opcional; si lo pone, debe ser el de su certificado
nivel = "opcional"            # los de terceros, siempre "opcional"
requiere = []                 # ids de otros plugins que deben estar habilitados
permisos = ["mapa.ir", "capas.leer"]

[distribucion]
modo = "catalogo"             # catalogo | independiente | privada
licencia = "MIT"              # MIT, Apache-2.0, GPL-3.0-or-later, EUPL-1.2, Propietaria…
precio = "gratuita"           # gratuita | pago | suscripcion | consultar
url = "https://su-sitio.com/mi_plugin"   # dónde se adquiere o se descarga
soporte = "soporte@su-sitio.com"         # opcional: correo o https://

[[instalar]]
accion = "mensaje"
texto = "Instalando Mi plugin"

[[habilitar]]
accion = "copiar"
desde = "web"
hacia = "{interfaz}/extensiones/mi_plugin"

[[deshabilitar]]
accion = "borrar"
ruta = "{interfaz}/extensiones/mi_plugin"

[[desinstalar]]
accion = "mensaje"
texto = "Mi plugin retirado"

[distribucion] es obligatoria. Los tres modos de la tabla de arriba se escriben catalogo, independiente (el comercial, que usted vende o entrega en su sitio) y privada. La url es obligatoria salvo en privada y empieza por https://.

Acciones. Al instalar se ejecuta [[instalar]] y luego [[habilitar]]. Los pasos posibles son:

PasoCamposUso
copiardesde, haciapublicar la página: copiar web a {interfaz}/extensiones/<id>
borrarrutaretirarla al deshabilitar
mensajetextodejar constancia en el resultado
sqlarchivoejecutar un .sql en la base de la plataforma (sólo en la edición con servidor)
ordenlineadesactivado en la plataforma; no lo use

No se admiten rutas absolutas ni ... Un paso sql tiene todos los permisos sobre la base: el administrador lo revisa antes de instalar y puede rechazarlo si no hace falta. python ipdeplug.py validar mi_plugin revisa el manifiesto sin firmar.

6.3 La página y el puente con el mapa

La página es un solo web/index.html autocontenido. El geoportal la abre en un marco sandbox="allow-scripts", así que:

Los permisos que puede declarar el manifiesto:

PermisoQué puede hacer el plugin
mapa.ircentrar el mapa en un punto (todos lo tienen)
capas.leerver la lista de capas del catálogo y del mapa, y leer sus datos en GeoJSON (WGS 84)
capas.agregarañadir una capa propia al mapa; queda en el Historial como cualquier capa subida
descargasguardar en el equipo del usuario un archivo que genera el plugin

Las plantillas traen el cliente del puente (el objeto ipde). Cada pedido lleva un número y la interfaz contesta con el mismo número o con ipde.error:

const capas = await ipde.capas();                 // [{id, titulo, grupo, geometria, enMapa, elementos}]
const fc = await ipde.datos(capas[0].id);         // FeatureCollection en WGS 84
await ipde.agregarCapa('Resultado', fc);          // {id, elementos}
await ipde.descargar('resultado.csv', texto, 'text/csv');
ipde.ir(-79.52, 8.98, 14);                        // lon, lat, zoom (sin respuesta)

Por debajo son estos mensajes:

Envía el pluginPermisoResponde la interfaz
{tipo:'ipde.ir', lon, lat, zoom}mapa.irnada: centra el mapa y pone un marcador
{tipo:'ipde.capas?', pedido}capas.leer{tipo:'ipde.capas', pedido, capas:[…]}
{tipo:'ipde.datos?', pedido, id}capas.leer{tipo:'ipde.datos', pedido, id, fc}
{tipo:'ipde.capa', pedido, titulo, fc}capas.agregar{tipo:'ipde.capa.ok', pedido, id, elementos}
{tipo:'ipde.descargar', pedido, nombre, texto, tipoMime}descargas{tipo:'ipde.descargar.ok', pedido}
{tipo:'ipde.tamano', grande}—nada: amplía o reduce el marco

Si falta el permiso o algo sale mal, la respuesta es {tipo:'ipde.error', pedido, error}. Límites: una capa añadida tiene hasta 100 000 elementos, con geometrías en grados; un archivo descargado y el paquete descomprimido pesan hasta 50 MB cada uno. Las capas que sólo se sirven como imagen (WMS) no tienen datos: ipde.datos? responde con un error.

6.4 El certificado de editor

Se pide una sola vez por editor, no por plugin. editor-solicitar crea la carpeta editor_<id>/ con dos archivos:

Envíe solicitud.json al administrador de la plataforma; puede acompañarla de una propuesta desde Sugerencias → Función nueva → Extensión propia (plugin), con la dirección donde se adquirirá. Recibirá publisher.cert.json: guárdelo junto a la clave privada. Dura lo que decida la autoridad, dos años por omisión.

6.5 Firmar y publicar

empaquetar revisa el manifiesto, calcula el SHA-256 de cada archivo, firma la lista con su clave, escribe META/ y crea el ZIP. Al final muestra el SHA-256 del paquete: publíquelo junto a la descarga para que se pueda comprobar. Después de firmar no toque la carpeta: cualquier cambio, aunque sea un espacio, invalida la firma. Para corregir algo, edite, suba la versión y vuelva a empaquetar.

Precio. La plataforma no cobra ni procesa pagos: la venta y las licencias de uso ocurren en su sitio. Si quiere limitar el uso a quien pagó, hágalo en su propio servicio, por ejemplo con una clave de licencia que el plugin compruebe contra su servidor.

Entrar al catálogo. Genere la ficha y envíela al administrador con el paquete:

python ipdeplug.py ficha mi_plugin-1.0.0.ipdeplug -o ficha.json

La ficha resume el paquete verificado (id, versión, editor, licencia, precio, permisos, url y SHA-256) y el administrador la añade a extensiones/indice.json. Si la plataforma no aloja el paquete, la ficha va sin archivo y el catálogo sólo enlaza a su sitio.

6.6 Instalación, versiones y seguridad

El administrador instala el paquete en Administrar → Extensiones → Instalar .ipdeplug (el navegador verifica la firma, el certificado y cada archivo antes de guardarlo) o, en la edición con servidor, con consola extension instalar mi_plugin-1.0.0.ipdeplug. Si algo no cuadra, el paquete se rechaza con uno de los mensajes de la sección 6.8 y el intento queda en la auditoría.

6.7 Para la autoridad de la plataforma

Emitir un certificado. Primero se comprueba la identidad del solicitante por un canal propio (correo de su dominio, contrato o llamada). Después:

python ipdeplug.py editor-emitir solicitud.json --raiz CARPETA_DE_LA_RAIZ --anios 2 --registro consola/firma/editores -o salida

Antes de firmar, la orden comprueba que la solicitud esté firmada con la clave que trae, que la raíz sea la de esta plataforma, que el id no lo use ya otro editor con otra clave (--reemplazar sólo si es la misma organización que perdió su clave) y que el nombre no tenga saltos de línea. Se devuelve salida/publisher.cert.json; la copia en --registro es el inventario de editores.

La clave raíz (root_private.pem) se guarda fuera de línea y fuera de todo repositorio. Si se compromete, hay que crear otra raíz y recompilar la consola y el geoportal con la nueva clave pública, y todos los certificados y paquetes anteriores dejan de valer.

Retirar a un editor. No hay lista de revocación: un certificado vale hasta que vence, por eso conviene emitirlos por uno o dos años. Ante un caso grave: quitar sus paquetes del catálogo, avisar a los administradores para que los desinstalen y no renovarle el certificado.

El catálogo es extensiones/indice.json. Una entrada con archivo (sólo plugins gratuitos alojados por la plataforma) se instala con un clic; sin archivo, enlaza a la url del editor:

{"paquetes": [
  {"archivo": "conversor.ipdeplug", "id": "conversor", "nombre": "Conversor de coordenadas", "descripcion": "…"},
  {"id": "mi_plugin", "nombre": "Mi plugin", "version": "1.0.0", "descripcion": "…", "editor": "Su Empresa S.A.",
   "licencia": "Propietaria", "precio": "pago", "url": "https://su-empresa.com/mi_plugin", "sha256": "…"}
]}

6.8 Mensajes de verificación

MensajeQué significa
SIN FIRMAR: falta META/…el paquete no se firmó o se le quitó META/
el certificado del editor no está firmado por la raíz de esta plataformacertificado de otra plataforma, de prueba o falsificado
el certificado del editor venció el …pida un certificado nuevo y vuelva a firmar
la firma del paquete no valida con la clave del editorse alteró META/hashes.json o se firmó con otra clave
«archivo» fue modificado después de firmarse cambió un archivo tras empaquetar
archivo no declarado en la firma / falta un archivo declaradose añadió o se quitó un archivo
id del manifiesto ≠ firma / versión del manifiesto ≠ firmase editó extension.toml después de firmar
el manifiesto declara otro editorel editor de extension.toml no es el del certificado
entrada de ZIP inválidarutas absolutas o con .. (se rechazan para no escribir fuera de la carpeta)

6.9 Formato del paquete .ipdeplug

clave raíz        --firma-->  META/publisher.cert.json   (certificado del editor)
clave del editor  --firma-->  META/hashes.json           (bytes crudos del archivo)
META/hashes.json  --cubre-->  SHA-256 de cada archivo fuera de META/

7. Entorno de desarrollo recomendado

Recomendamos Visual Studio Code (VS Code): es gratuito, funciona en Windows, macOS y Linux, y edita HTML, JavaScript, Python y TOML en un mismo sitio. El proyecto que crea el SDK trae la lista de extensiones recomendadas; VS Code propone instalarlas al abrir la carpeta (code mi_plugin):

Alternativas: VSCodium (el mismo editor, 100 % libre y sin telemetría), WebStorm o PyCharm. Para el ciclo de trabajo basta la terminal integrada:

  1. Editar la página.
  2. Correr probar.
  3. Recargar el banco de pruebas.
  4. Hacer el commit con git.

8. Usar la inteligencia artificial para crear plugins

Un asistente de IA acelera mucho el desarrollo: escribe la página, conecta el puente con el mapa, propone pruebas y explica errores.

El proyecto que crea el SDK ya viene preparado:

Abra el proyecto y pida lo que necesita en lenguaje natural, por ejemplo:

Quiero que el plugin calcule el área de cada polígono de la capa elegida en hectáreas,
la muestre en una tabla ordenable y permita descargarla en CSV.
Usa sólo los permisos necesarios y pruébalo con «python ipdeplug.py probar .».

Buenas prácticas:

  1. Cambios pequeños y probados. Pida un cambio y pruébelo en el banco antes de pedir el siguiente.
  2. Revise lo que propone. Usted firma el paquete y responde por él.
  3. Nunca le entregue su clave privada. Firme usted con empaquetar. El proyecto la deja fuera de git y AGENTS.md le prohíbe leerla.
  4. Seguridad de los datos. Pida que escape los textos que vienen de las capas y que declare si envía datos a un servicio externo.
  5. Licencias. Si la IA reutiliza código de terceros, incluya sus avisos de licencia.
  6. Memoria del proyecto. Mantenga AGENTS.md al día con las reglas propias de su plugin.

9. Licencia y autoría

Isocarta es software libre: se puede usar, estudiar, modificar y distribuir. La licencia propuesta es AGPL-3.0-o-posterior con una excepción para extensiones:

Autoría. © 2026 Edgar Méndez Durán: desarrollador. José María Agüero: QA. Agricultura Científica S.A. (AgriCien): empresa desarrolladora. El autor se reserva únicamente los derechos morales: que se le reconozca la autoría y que no se presente una versión modificada como si fuera la original. No se reserva derechos patrimoniales más allá de lo que exige la licencia.

Acerca del autor. Edgar Méndez Durán es geógrafo (Licenciatura en Geografía, Universidad de Costa Rica), con maestría en Sistemas de Información Geográfica y Teledetección (UCR–UNA). Tiene más de 25 años de experiencia en SIG, bases de datos espaciales, inteligencia de negocios y análisis de datos, con proyectos en América, Europa, Asia, Oceanía y África. Es profesor universitario de SIG, geografía física, climatología y cartografía (UCR; UNED de 1997 a 2025). Contacto: edgarmendezduran@gmail.com.

Acerca de José María Agüero (QA). Fundador y presidente de Agricultura Científica S.A. (AgriCien) desde 1992, donde también fue director general y gerente general hasta 2024. Licenciado en Suelos (Universidad de Costa Rica), con formación en INCAE Business School. Tiene más de 34 años de experiencia en manejo del agua en la agricultura y la ganadería, nivelación de terrenos en 3D, producción de arroz en el trópico, agricultura de precisión y control de maquinaria, cosecha de agua, regeneración de suelos y desarrollo de proyectos agropecuarios. Contacto: jose.aguero@agricien.com.