<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: claudio matko</title>
    <description>The latest articles on DEV Community by claudio matko (@matko).</description>
    <link>https://dev.to/matko</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F652170%2F70b6919d-eaeb-4643-a81e-d18c64b37883.jpg</url>
      <title>DEV Community: claudio matko</title>
      <link>https://dev.to/matko</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/matko"/>
    <language>en</language>
    <item>
      <title>Cómo desplegar QuickMapServices, el catálogo abierto de geoservicios, en una aplicación personal</title>
      <dc:creator>claudio matko</dc:creator>
      <pubDate>Tue, 10 Nov 2026 18:38:44 +0000</pubDate>
      <link>https://dev.to/matko/como-desplegar-quickmapservices-el-catalogo-abierto-de-geoservicios-en-una-aplicacion-personal-6jo</link>
      <guid>https://dev.to/matko/como-desplegar-quickmapservices-el-catalogo-abierto-de-geoservicios-en-una-aplicacion-personal-6jo</guid>
      <description>&lt;p&gt;&lt;a href="//qms.nextgis.com"&gt;&lt;strong&gt;QuickMapServices (QMS)&lt;/strong&gt;&lt;/a&gt; es un &lt;strong&gt;&lt;em&gt;catálogo abierto y colaborativo de geoservicios&lt;/em&gt;&lt;/strong&gt;. Este recurso vino a resolver nada más ni nada menos que la búsqueda de geoservicios. &lt;/p&gt;

&lt;p&gt;Entre sus principales beneficios, se puede destacar la exploración de servicios disponibles, la visualización de capas de vista previa, la posibilidad de verificar metadatos y licencias de los servicios, la posibilidad de aportar nuevos servicios y la integración con aplicaciones personalizadas.&lt;/p&gt;

&lt;p&gt;Este recurso, que ya cuenta con entidad propia, es el alma del conocido &lt;a href="https://plugins.qgis.org/plugins/quick_map_services/" rel="noopener noreferrer"&gt;&lt;strong&gt;plugin de QGIS&lt;/strong&gt;&lt;/a&gt; que lleva el mismo nombre. Es el plugin más popular de QGIS, superando las &lt;a href="https://plugins.qgis.org/metabase/public/dashboard/7ecd345f-7321-423d-9844-71e526a454a9" rel="noopener noreferrer"&gt;&lt;strong&gt;12 millones de descargas&lt;/strong&gt;&lt;/a&gt;. &lt;/p&gt;

&lt;p&gt;Pero por qué es tan importante &lt;strong&gt;QMS&lt;/strong&gt;?, se puede decir que su valor yace en que los mapas base dan rápidamente contexto geográfico a cualquier proyecto GIS. El uso de estos servicios conlleva un valor agregado muy importante. Por tanto, contar con un mecanismo apoyado en un inventario que instantáneamente lleve al contexto de QGIS un catálogo inmenso de estos servicios, presupone ya mismo una gran ventaja. Aunque, como veremos a continuación, no es la única.   &lt;/p&gt;

&lt;p&gt;Con más de 11 años de edad, este catálogo concentra hoy &lt;a href="//qms.nextgis.com"&gt;&lt;strong&gt;+1000 servicios&lt;/strong&gt;&lt;/a&gt; y en su evolución cuenta con &lt;a href="https://nextgis.es/blog/explora-qms-en-el-mapa/" rel="noopener noreferrer"&gt;&lt;strong&gt;importantes actualizaciones&lt;/strong&gt;&lt;/a&gt; que facilitan la búsqueda y la contribución de geoservicios. &lt;/p&gt;

&lt;p&gt;Una nueva vista del catálogo basada en mapas, que integra búsqueda directa, filtrado por tipo de servicio (TMS, Vector Tiles, WMS, WFS o GeoJSON) y previsualización en tiempo real en una única interfaz para comparar capas con &lt;a href="https://www.openstreetmap.org/" rel="noopener noreferrer"&gt;OpenStreetMap&lt;/a&gt; y la compatibilidad con servicios de teselas vectoriales, que ofrecen información más nítida en todos los niveles de zoom y apariencia personalizable. &lt;/p&gt;

&lt;p&gt;Además, los usuarios ya pueden añadir sus propios servicios de teselas vectoriales a este catálogo colaborativo, cuyo valor reside en las contribuciones de la comunidad geoespacial y cuya &lt;a href="https://code.nextgis.com/qms-core-readme" rel="noopener noreferrer"&gt;API pública&lt;/a&gt; permite integrarlo en aplicaciones GIS de escritorio, web y móviles.&lt;/p&gt;

&lt;p&gt;Si no lo conocías ya, ahora sabés de qué se trata QMS, conocés algo de su historia y por qué se transformó en el plugin más popular de QGIS. Pero este artículo trata sobre algo más. &lt;/p&gt;

&lt;p&gt;A continuación repasaremos los pasos para ensayar el despliegue de QMS en una aplicación personal, con el objetivo de tener una experiencia interactiva de integración. Siguiendo estos pasos podrás replicar lo necesario para empezar a integrar QMS en tus aplicaciones. &lt;/p&gt;

&lt;p&gt;Todas las indicaciones están preparadas para ser ejecutadas en la distribución &lt;a href="https://ubuntu.com/" rel="noopener noreferrer"&gt;Ubuntu&lt;/a&gt; de &lt;a href="https://www.getgnulinux.org/es/" rel="noopener noreferrer"&gt;GNU/Linux&lt;/a&gt;. Es el sistema operativo que se ha sabido ganar, no solo su espacio entre usuarios de escritorio, sino también, un lugar muy especial entre usuarios de servidores. &lt;/p&gt;

&lt;p&gt;En este punto es oportuno destacar también que, este artículo se basa en la documentación oficial de &lt;a href="https://nextgis.es/" rel="noopener noreferrer"&gt;NextGIS&lt;/a&gt;, creadores de QMS. En &lt;a href="https://code.nextgis.com" rel="noopener noreferrer"&gt;code.nextgis.com&lt;/a&gt;, podés hallar todo lo necesario para programar, dentro del ecosistema de software. Para el caso de QMS, existe una API y tres bibliotecas: &lt;a href="https://code.nextgis.com/qms-leaflet-readme" rel="noopener noreferrer"&gt;&lt;strong&gt;Leaflet&lt;/strong&gt;&lt;/a&gt;, &lt;a href="https://code.nextgis.com/qms-maplibre-gl-readme" rel="noopener noreferrer"&gt;&lt;strong&gt;MapLibre&lt;/strong&gt;&lt;/a&gt;, &lt;a href="https://code.nextgis.com/qms-ol-readme" rel="noopener noreferrer"&gt;&lt;strong&gt;OpenLayers&lt;/strong&gt;&lt;/a&gt;. Para el caso específico del ejemplo la podés hallar haciendo clic &lt;a href="https://code.nextgis.com/qms-leaflet-examples-fit-service" rel="noopener noreferrer"&gt;&lt;strong&gt;acá&lt;/strong&gt;&lt;/a&gt;. &lt;/p&gt;

&lt;h2&gt;
  
  
  QMS integración en cualquier lugar
&lt;/h2&gt;

&lt;p&gt;En 5 pasos:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;1. Instalar Node.js&lt;/li&gt;
&lt;li&gt;2. Crear un proyecto (versión Leaflet)&lt;/li&gt;
&lt;li&gt;3. Despliegue y visualización&lt;/li&gt;
&lt;li&gt;4. Compartir el mapa con QMS integrado por Cloudflare Tunnel&lt;/li&gt;
&lt;li&gt;5. Cambiar a OpenLayers o MapLibre&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Comencemos! &lt;/p&gt;

&lt;h3 id="paso-1"&gt;1. Instalar Node.js&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://nodejs.org/learn/getting-started/introduction-to-nodejs" rel="noopener noreferrer"&gt;&lt;strong&gt;Node.js&lt;/strong&gt;&lt;/a&gt; es un entorno de ejecución de JavaScript de código abierto y multiplataforma. Es una herramienta popular para casi cualquier tipo de proyecto. Con esta herramienta se ejecuta el motor JavaScript V8, fuera del navegador. Esto permite que Node.js tenga un rendimiento muy alto. A continuación copia el código para instalar Node 18 o superior.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;sudo apt update
sudo apt install -y curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh &lt;span class="o"&gt;|&lt;/span&gt; bash
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Cerrá y abrí la terminal y después:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;nvm install 20
node -v    &lt;span class="c"&gt;# debe mostrar v20.x&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3 id="paso-2"&gt;2. Crear un proyecto (versión Leaflet)&lt;/h3&gt;

&lt;p&gt;Para este ejemplo decidí utilizar &lt;a href="https://leafletjs.com/" rel="noopener noreferrer"&gt;&lt;strong&gt;Leaflet&lt;/strong&gt;&lt;/a&gt;, pero podés incursionar con &lt;a href="https://openlayers.org/" rel="noopener noreferrer"&gt;&lt;em&gt;OpenLayers&lt;/em&gt;&lt;/a&gt; o &lt;a href="https://maplibre.org/" rel="noopener noreferrer"&gt;&lt;em&gt;MapLibre&lt;/em&gt;&lt;/a&gt; también. Hacia el final te doy las indicaciones. &lt;/p&gt;

&lt;p&gt;A continuación, lo que vas a hacer es crear la carpeta &lt;code&gt;~/qms-demo&lt;/code&gt;, los tres archivos, instalar las dependencias y arrancar el servidor.&lt;/p&gt;

&lt;p&gt;Prepara un directorio de trabajo limpio, una carpeta vacía como directorio actual.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;rm -rf ~/qms-demo &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; mkdir -p ~/qms-demo &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nb"&gt;cd&lt;/span&gt; ~/qms-demo
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Crea el archivo &lt;code&gt;index.html&lt;/code&gt;, es el esqueleto de la demo. El archivo generado es una página HTML mínima, carga un script de módulo &lt;code&gt;main.js&lt;/code&gt; donde irá la lógica del mapa con &lt;em&gt;QMS&lt;/em&gt;.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;cat &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; index.html &lt;span class="o"&gt;&amp;lt;&amp;lt;&lt;/span&gt;&lt;span class="s1"&gt;'EOF'&lt;/span&gt;
&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;!doctype html&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;html &lt;span class="nv"&gt;lang&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"es"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;head&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;meta &lt;span class="nv"&gt;charset&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"UTF-8"&lt;/span&gt; /&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;meta &lt;span class="nv"&gt;name&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"viewport"&lt;/span&gt; &lt;span class="nv"&gt;content&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"width=device-width, initial-scale=1"&lt;/span&gt; /&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;title&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;Demo QMS&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;/title&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;style&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      html, body &lt;span class="o"&gt;{&lt;/span&gt; margin: 0&lt;span class="o"&gt;;&lt;/span&gt; height: 100%&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="o"&gt;}&lt;/span&gt;
      &lt;span class="c"&gt;#map { width: 100%; height: 100vh; }&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;/style&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;/head&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;body&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;div &lt;span class="nv"&gt;id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"map"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&amp;lt;&lt;/span&gt;/div&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;script &lt;span class="nv"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"module"&lt;/span&gt; &lt;span class="nv"&gt;src&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"/main.js"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&amp;lt;&lt;/span&gt;/script&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;/body&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;/html&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
EOF
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Crea un archivo &lt;code&gt;main.js&lt;/code&gt; que inicializa un mapa &lt;em&gt;Leaflet&lt;/em&gt; con una capa del catálogo &lt;em&gt;QuickMapServices&lt;/em&gt; y un control para cambiar entre mapas base del catálogo &lt;em&gt;QMS&lt;/em&gt;. En &lt;code&gt;.setView([-34.6, -58.4], 11)&lt;/code&gt;, podés configurar la vista de la zona de interés que querés que se visualice al iniciar. Para este ejemplo utilicé la localidad de Buenos Aires &lt;code&gt;[-34.6, -58.4]&lt;/code&gt;. Si no sabés cuál es exactamente la posición de la localidad de interés, existen muchos recursos para hallarla, uno de ellos es &lt;a href="https://epsg.io/map#srs=4326&amp;amp;x=0.000000&amp;amp;y=0.000000&amp;amp;z=1&amp;amp;layer=streets" rel="noopener noreferrer"&gt;&lt;strong&gt;epsg.io&lt;/strong&gt;&lt;/a&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;cat &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; main.js &lt;span class="o"&gt;&amp;lt;&amp;lt;&lt;/span&gt;&lt;span class="s1"&gt;'EOF'&lt;/span&gt;
import &lt;span class="o"&gt;{&lt;/span&gt; map as createMap &lt;span class="o"&gt;}&lt;/span&gt; from &lt;span class="s1"&gt;'leaflet'&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt;
import &lt;span class="s1"&gt;'leaflet/dist/leaflet.css'&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt;
import &lt;span class="s1"&gt;'@nextgis/qms-leaflet/lib/qms-leaflet.css'&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt;
import &lt;span class="o"&gt;{&lt;/span&gt; addQmsLayer, createQmsControl &lt;span class="o"&gt;}&lt;/span&gt; from &lt;span class="s1"&gt;'@nextgis/qms-leaflet'&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt;

async &lt;span class="k"&gt;function&lt;/span&gt; init&lt;span class="o"&gt;(&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt; &lt;span class="o"&gt;{&lt;/span&gt;
  const map &lt;span class="o"&gt;=&lt;/span&gt; createMap&lt;span class="o"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'map'&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;.setView&lt;span class="o"&gt;(&lt;/span&gt;&lt;span class="o"&gt;[&lt;/span&gt;-34.6, -58.4&lt;span class="o"&gt;]&lt;/span&gt;, 11&lt;span class="o"&gt;)&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt;
  await addQmsLayer&lt;span class="o"&gt;(&lt;/span&gt;map, 448&lt;span class="o"&gt;)&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt;
  map.addControl&lt;span class="o"&gt;(&lt;/span&gt;createQmsControl&lt;span class="o"&gt;(&lt;/span&gt;&lt;span class="o"&gt;{&lt;/span&gt; initialLayer: 448, position: &lt;span class="s1"&gt;'topright'&lt;/span&gt; &lt;span class="o"&gt;}&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt;
&lt;span class="o"&gt;}&lt;/span&gt;

init&lt;span class="o"&gt;(&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;.catch&lt;span class="o"&gt;(&lt;/span&gt;console.error&lt;span class="o"&gt;)&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt;
EOF
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Crea el archivo &lt;code&gt;package.json&lt;/code&gt; en el directorio actual. Define el proyecto &lt;strong&gt;qms-demo&lt;/strong&gt; e incluye: scripts, dependencias, Vite como servidor de desarrollo y empaquetador.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;cat &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; package.json &lt;span class="o"&gt;&amp;lt;&amp;lt;&lt;/span&gt;&lt;span class="s1"&gt;'EOF'&lt;/span&gt;
&lt;span class="o"&gt;{&lt;/span&gt;
  &lt;span class="s2"&gt;"name"&lt;/span&gt;: &lt;span class="s2"&gt;"qms-demo"&lt;/span&gt;,
  &lt;span class="s2"&gt;"private"&lt;/span&gt;: true,
  &lt;span class="s2"&gt;"version"&lt;/span&gt;: &lt;span class="s2"&gt;"1.0.0"&lt;/span&gt;,
  &lt;span class="s2"&gt;"type"&lt;/span&gt;: &lt;span class="s2"&gt;"module"&lt;/span&gt;,
  &lt;span class="s2"&gt;"scripts"&lt;/span&gt;: &lt;span class="o"&gt;{&lt;/span&gt;
    &lt;span class="s2"&gt;"dev"&lt;/span&gt;: &lt;span class="s2"&gt;"vite --host"&lt;/span&gt;,
    &lt;span class="s2"&gt;"build"&lt;/span&gt;: &lt;span class="s2"&gt;"vite build"&lt;/span&gt;
  &lt;span class="o"&gt;}&lt;/span&gt;,
  &lt;span class="s2"&gt;"dependencies"&lt;/span&gt;: &lt;span class="o"&gt;{&lt;/span&gt;
    &lt;span class="s2"&gt;"@nextgis/qms-leaflet"&lt;/span&gt;: &lt;span class="s2"&gt;"latest"&lt;/span&gt;,
    &lt;span class="s2"&gt;"leaflet"&lt;/span&gt;: &lt;span class="s2"&gt;"latest"&lt;/span&gt;
  &lt;span class="o"&gt;}&lt;/span&gt;,
  &lt;span class="s2"&gt;"devDependencies"&lt;/span&gt;: &lt;span class="o"&gt;{&lt;/span&gt;
    &lt;span class="s2"&gt;"vite"&lt;/span&gt;: &lt;span class="s2"&gt;"latest"&lt;/span&gt;
  &lt;span class="o"&gt;}&lt;/span&gt;
&lt;span class="o"&gt;}&lt;/span&gt;
EOF
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Instala todas las dependencias declaradas en &lt;code&gt;package.json&lt;/code&gt;. Si la instalación tiene éxito (&lt;code&gt;&amp;amp;&amp;amp;&lt;/code&gt;), arranca el servidor de desarrollo de Vite (&lt;code&gt;npm run dev&lt;/code&gt;), que sirve la demo con recarga en caliente para poder verla en el navegador.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; npm run dev
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3 id="paso-3"&gt;3. Despliegue y visualización&lt;/h3&gt;

&lt;p&gt;Abrí la URL que figura en tu terminal, en este ejemplo &lt;code&gt;http://localhost:5174/&lt;/code&gt; ó &lt;code&gt;http://192.168.0.3:5174/&lt;/code&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;  VITE v8.3.7  ready &lt;span class="k"&gt;in&lt;/span&gt; 195 ms

  ➜  Local:   http://localhost:5174/
  ➜  Network: http://192.168.0.3:5174/  wlp4s0
  ➜  press h + enter to show &lt;span class="nb"&gt;help&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Verás localmente en el entorno de tu red, el mapa de tu zona de interés con el control de búsqueda de QMS arriba a la derecha.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fwepdukzwhl3ax0y4ho5p.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fwepdukzwhl3ax0y4ho5p.png" alt="pc" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Ya tenés en tu propia aplicación QMS integrado! &lt;/p&gt;

&lt;p&gt;Ahora podés desplegar el menú de QMS y buscar cualquiera de los servicios integrados al catálogo para visualizar en la aplicación. &lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fraw.githubusercontent.com%2Fmatkoclaudio%2Fqms-api-2026%2Fmain%2Fdocs%2Fimages%2F2026-11-10%252012-59-27-00.00.06.821-00.00.52.713_034.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fraw.githubusercontent.com%2Fmatkoclaudio%2Fqms-api-2026%2Fmain%2Fdocs%2Fimages%2F2026-11-10%252012-59-27-00.00.06.821-00.00.52.713_034.gif" alt="gif" width="720" height="405"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Para volver a ejecutarlo, después de cerrar la terminal, no te olvides de ejecutar:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;cd&lt;/span&gt; ~/qms-demo &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; npm run dev
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Si querés compartir la visualización rápidamente, con un colega fuera de tu red, existen varios caminos. A continuación te propongo uno de ellos. &lt;/p&gt;

&lt;p&gt;Para evitar riesgos lógicos de seguridad de tu red, lo que te propongo a continuación es construir un túnel, para que por él salga la visualización de tu aplicación fuera de tu red. &lt;/p&gt;

&lt;p&gt;Es importante destacar que esto es temporal, por lo tanto, solo tendrá efecto en el momento en que lo ejecutes y perderá validez cuando termines la sesión de la terminal. &lt;/p&gt;

&lt;h3 id="paso-4"&gt;4. Compartir el mapa con QMS integrado por Cloudflare Tunnel&lt;/h3&gt;

&lt;p&gt;En solo 3 pasos:&lt;/p&gt;

&lt;h3&gt;
  
  
  Instalá Cloudflared
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://www.cloudflare.com/es-es/" rel="noopener noreferrer"&gt;&lt;strong&gt;Cloudflare&lt;/strong&gt;&lt;/a&gt; actúa como intermediario entre los usuarios e internet para acelerar y proteger servicios web.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;cd&lt;/span&gt; /tmp
curl -L -o cloudflared.deb https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb
sudo dpkg -i cloudflared.deb
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Configurar Vite para aceptar el túnel
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://es.vite.dev/guide/#avanzado" rel="noopener noreferrer"&gt;&lt;strong&gt;Vite&lt;/strong&gt;&lt;/a&gt; es una herramienta de compilación para proyectos web modernos, diseñada para ofrecer una experiencia de desarrollo mucho más rápida y ágil. &lt;/p&gt;

&lt;p&gt;Genera un archivo de configuración de Vite listo para servir la aplicación en red y a través de un túnel de Cloudflare. Ejecutá lo siguiente en la terminal:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;cd&lt;/span&gt; ~/qms-demo
cat &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; vite.config.js &lt;span class="o"&gt;&amp;lt;&amp;lt;&lt;/span&gt;&lt;span class="s1"&gt;'EOF'&lt;/span&gt;
&lt;span class="kd"&gt;export&lt;/span&gt; default &lt;span class="o"&gt;{&lt;/span&gt;
  server: &lt;span class="o"&gt;{&lt;/span&gt;
    host: true,
    port: 5174,
    strictPort: true,
    allowedHosts: &lt;span class="o"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'.trycloudflare.com'&lt;/span&gt;&lt;span class="o"&gt;]&lt;/span&gt;,
  &lt;span class="o"&gt;}&lt;/span&gt;,
&lt;span class="o"&gt;}&lt;/span&gt;&lt;span class="o"&gt;;&lt;/span&gt;
EOF
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Recordá verificar que el puerto al que estás apuntando sea el correcto. Para este ejemplo es &lt;code&gt;5174&lt;/code&gt;. En caso de tener inconvenientes con esto, verificá con:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl -I http://localhost:5174
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Si devuelve &lt;code&gt;HTTP/1.1 200 OK&lt;/code&gt;, Vite está en orden, si por el contrario dice &lt;code&gt;Failed to connect&lt;/code&gt;, Vite no está corriendo o está en otro puerto. Para remediarlo levantá el túnel apuntando al puerto correcto, para saber cuál es el puerto donde está escuchando Vite ejecutá:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;ss -ltnp &lt;span class="o"&gt;|&lt;/span&gt; grep node
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Levantá el visualizador y el túnel
&lt;/h3&gt;

&lt;p&gt;Inicia el servidor de desarrollo del proyecto en &lt;code&gt;~/qms-demo&lt;/code&gt;, que sirve el visualizador en tu máquina. Es decir, pone la aplicación a correr localmente. Debido a que el túnel será temporal, vas a necesitar para este caso, correr dos terminales simultáneamente: una para la aplicación local, &lt;em&gt;Terminal 1&lt;/em&gt; y otra para el túnel, &lt;em&gt;Terminal 2&lt;/em&gt;, que te permitirá compartir la aplicación fuera de tu red. &lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Terminal 1&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;cd&lt;/span&gt; ~/qms-demo
npm run dev
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Crea un túnel de Cloudflare que expone ese servidor local a Internet mediante una URL pública temporal. Así, personas fuera de tu red pueden acceder a tu visualizador sin necesidad de configurar puertos, firewall ni DNS.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Terminal 2&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;cloudflared tunnel --url http://localhost:5174
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Importante, reemplazá &lt;code&gt;http://localhost:5174&lt;/code&gt;, por tu dirección, la que obtuviste anteriormente&lt;/p&gt;

&lt;p&gt;Al ejecutar &lt;strong&gt;Cloudflared&lt;/strong&gt;, vas a recibir en unos instantes una URL en tu terminal. Esa es la URL que podés compartir con quien quieras dar acceso al túnel. El aspecto de la URL será semejante a &lt;code&gt;https://algo-como-esto.trycloudflare.com&lt;/code&gt;&lt;/p&gt;

&lt;p&gt;Ahora podés pedir a tus colegas, fuera de tu red, que te den su opinión respecto a tu trabajo, podés verificar cómo se visualiza tu aplicación y si requiere de algún ajuste adicional. &lt;/p&gt;

&lt;p&gt;También podés probar cómo se ve desde tu teléfono móvil:&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fbua9chz7sqopu6am0ze1.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fbua9chz7sqopu6am0ze1.png" alt="movil" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Buscá el servicio que más te guste. &lt;/p&gt;

&lt;h3 id="paso-5"&gt;5. Cambiar a OpenLayers o MapLibre&lt;/h3&gt;

&lt;p&gt;Como lo adelanté al principio, esta guía cuenta con un ejemplo basado en &lt;a href="https://leafletjs.com/" rel="noopener noreferrer"&gt;&lt;em&gt;Leaflet&lt;/em&gt;&lt;/a&gt;, aunque si querés probar con &lt;a href="https://openlayers.org/" rel="noopener noreferrer"&gt;&lt;strong&gt;Openlayers&lt;/strong&gt;&lt;/a&gt; o &lt;a href="https://maplibre.org/" rel="noopener noreferrer"&gt;&lt;strong&gt;MapLibre&lt;/strong&gt;&lt;/a&gt;, te dejo a continuación, las instrucciones para que sigas adelante. Es importante destacar que el &lt;code&gt;index.html&lt;/code&gt; no cambia, solo hay que reemplazar el contenido de &lt;code&gt;main.js&lt;/code&gt; y las dependencias del &lt;code&gt;package.json&lt;/code&gt;:&lt;/p&gt;

&lt;h3&gt;
  
  
  &lt;a href="https://openlayers.org/" rel="noopener noreferrer"&gt;OpenLayers&lt;/a&gt;:
&lt;/h3&gt;

&lt;p&gt;Info oficial de NextGIS, clic &lt;a href="https://code.nextgis.com/qms-ol-readme" rel="noopener noreferrer"&gt;&lt;strong&gt;acá&lt;/strong&gt;&lt;/a&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;cd&lt;/span&gt; ~/qms-demo
npm uninstall leaflet @nextgis/qms-leaflet
npm install ol @nextgis/qms-ol
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// main.js&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nb"&gt;Map&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'ol/Map'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nc"&gt;View&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'ol/View'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;fromLonLat&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'ol/proj'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="s1"&gt;'ol/ol.css'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="s1"&gt;'@nextgis/qms-ol/lib/qms-ol.css'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;addQmsLayer&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;createQmsControl&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'@nextgis/qms-ol'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;init&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;map&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Map&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="n"&gt;target&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'map'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;view&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;View&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;center&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;fromLonLat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="mf"&gt;58.4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="mf"&gt;34.6&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;zoom&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;11&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;addQmsLayer&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;map&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;448&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="n"&gt;map&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;addControl&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;createQmsControl&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;initialLayer&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;448&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="nf"&gt;init&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="k"&gt;catch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;error&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  &lt;a href="https://maplibre.org/" rel="noopener noreferrer"&gt;MapLibre GL&lt;/a&gt;:
&lt;/h3&gt;

&lt;p&gt;Info oficial de NextGIS, clic &lt;a href="https://code.nextgis.com/qms-maplibre-gl-readme" rel="noopener noreferrer"&gt;&lt;strong&gt;acá&lt;/strong&gt;&lt;/a&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;
&lt;span class="nb"&gt;cd&lt;/span&gt; ~/qms-demo
npm uninstall leaflet @nextgis/qms-leaflet
npm install maplibre-gl @nextgis/qms-maplibre-gl

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// main.js&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nb"&gt;Map&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;NavigationControl&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'maplibre-gl'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="s1"&gt;'maplibre-gl/dist/maplibre-gl.css'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="s1"&gt;'@nextgis/qms-maplibre-gl/lib/qms-maplibre-gl.css'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;addQmsLayer&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;createQmsControl&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'@nextgis/qms-maplibre-gl'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;map&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Map&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;container&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'map'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;style&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;version&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;8&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;sources&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;layers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;center&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="mf"&gt;58.4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="mf"&gt;34.6&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;zoom&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;10&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;map&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;addControl&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;NavigationControl&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'top-right'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;map&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;once&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'load'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nf"&gt;addQmsLayer&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;map&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;448&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="k"&gt;catch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;error&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="n"&gt;map&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;addControl&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;createQmsControl&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;initialLayer&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;448&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'top-left'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Pensamientos finales
&lt;/h2&gt;

&lt;p&gt;A lo largo de este artículo exploramos cómo &lt;strong&gt;&lt;em&gt;QuickMapServices&lt;/em&gt;&lt;/strong&gt; puede trascender su rol como plugin de QGIS para convertirse en una pieza clave dentro de aplicaciones geoespaciales personalizadas. &lt;/p&gt;

&lt;p&gt;Partiendo de la documentación oficial de NextGIS, recorrimos un camino que va desde la instalación de Node.js hasta el despliegue de un visor interactivo con Leaflet, presentando la posibilidad de compartir nuestro desarrollo mediante un túnel temporal con Cloudflare y culminando con la posibilidad de continuar la integración con OpenLayers y MapLibre GL.&lt;/p&gt;

&lt;p&gt;Este recorrido demuestra que &lt;strong&gt;&lt;em&gt;QMS&lt;/em&gt;&lt;/strong&gt; no es solo un catálogo de servicios, sino una puerta de entrada para que desarrolladores y usuarios avanzados puedan incorporar capas base y servicios WMS/WMTS de manera sencilla y estandarizada en sus propios proyectos. &lt;/p&gt;

&lt;p&gt;La versatilidad de las tres bibliotecas presentadas (Leaflet, OpenLayers y MapLibre GL) permite adaptar la solución a distintos contextos, desde prototipos rápidos hasta aplicaciones de alto rendimiento con renderizado vectorial.&lt;/p&gt;

&lt;p&gt;El ejemplo práctico evidencia que con pocas líneas de código y una estructura mínima de archivos es posible tener un mapa funcional con el control de búsqueda de QMS integrado, sin necesidad de infraestructura compleja.&lt;/p&gt;

&lt;p&gt;Este artículo buscó no solo mostrar cómo hacerlo, sino también inspirar a explorar las posibilidades que se abren al integrar QMS en aplicaciones propias. La invitación queda hecha: experimentar, adaptar los ejemplos a otras regiones o necesidades y aprovechar el ecosistema abierto que QMS y las bibliotecas, nos ofrecen. La geoinformación al alcance de todos.&lt;/p&gt;

</description>
      <category>qms</category>
      <category>gis</category>
      <category>nextgis</category>
      <category>webmap</category>
    </item>
    <item>
      <title>Automatización para la limpieza masiva de gaps basada en Python, QGIS headless y NextGIS Toolbox SDK</title>
      <dc:creator>claudio matko</dc:creator>
      <pubDate>Mon, 24 Aug 2026 19:51:47 +0000</pubDate>
      <link>https://dev.to/matko/limpiar-gaps-de-miles-de-poligonos-automaticamente-con-python-qgis-headless-y-nextgis-toolbox-sdk-11im</link>
      <guid>https://dev.to/matko/limpiar-gaps-de-miles-de-poligonos-automaticamente-con-python-qgis-headless-y-nextgis-toolbox-sdk-11im</guid>
      <description>&lt;p&gt;Imaginá que tenés más de &lt;strong&gt;12000 registros&lt;/strong&gt; en una base de datos espacial, cada uno con un polígono que representa una parcela, una zona urbana o un hábitat. Al primer análisis visual, descubrís que:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Algunos polígonos tienen &lt;strong&gt;auto-intersecciones&lt;/strong&gt; (mal dibujados).&lt;/li&gt;
&lt;li&gt;Los bordes de polígonos adyacentes &lt;strong&gt;no coinciden&lt;/strong&gt; (cada uno tiene sus propios nodos).&lt;/li&gt;
&lt;li&gt;Entre muchos de ellos hay &lt;strong&gt;huecos (gaps)&lt;/strong&gt; que deberían estar cerrados.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;La corrección manual mediante herramientas convencionales de digitalización es inviable en conjuntos de datos de gran escala, por lo que se propone un &lt;strong&gt;&lt;em&gt;flujo automatizado&lt;/em&gt;&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;En este artículo te muestro cómo construir un &lt;strong&gt;pipeline en Python&lt;/strong&gt; que combina:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;NextGIS Toolbox&lt;/strong&gt; (nube, vía SDK) para reparar geometrías inválidas.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;QGIS Process&lt;/strong&gt; (local, sin interfaz gráfica) para cerrar gaps y limpiar residuos.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;El resultado: una capa con un &lt;strong&gt;mismo número de features&lt;/strong&gt;, pero con geometrías válidas y aristas coincidentes.&lt;/p&gt;




&lt;h2&gt;
  
  
  El problema: dos tipos de errores
&lt;/h2&gt;

&lt;p&gt;En el mundo de los datos geográficos, los polígonos pueden sufrir dos tipos de problemas muy distintos:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Problema&lt;/th&gt;
&lt;th&gt;Naturaleza&lt;/th&gt;
&lt;th&gt;Ejemplo&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;strong&gt;Auto-intersección&lt;/strong&gt; (Self‑intersection)&lt;/td&gt;
&lt;td&gt;Validez OGC (intra‑polígono)&lt;/td&gt;
&lt;td&gt;Un lazo que se cruza a sí mismo.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Bordes no coincidentes y Gaps&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Topología (inter‑polígonos)&lt;/td&gt;
&lt;td&gt;Dos polígonos vecinos que deberían tocarse pero dejan un hueco.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;La solución no es única: &lt;strong&gt;reparar la validez no cierra gaps&lt;/strong&gt;, y &lt;strong&gt;cerrar gaps sin reparar inválidas&lt;/strong&gt; genera resultados impredecibles. Para resolver este problema es necesario contar con un &lt;em&gt;flujo de trabajo combinado&lt;/em&gt;.&lt;/p&gt;




&lt;h2&gt;
  
  
  Arquitectura del pipeline
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;NextGIS Toolbox&lt;/strong&gt; en la nube (a través de su SDK Python) → nos da la validez.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;QGIS&lt;/strong&gt; local (vía &lt;code&gt;qgis_process&lt;/code&gt; sin GUI) → resuelve la topología.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;El flujo sería el siguiente:&lt;/p&gt;

&lt;p&gt;Capa original (+12k polígonos)&lt;br&gt;
├─ [NextGIS Toolbox] &lt;a href="https://toolbox.nextgis.com/t/check_geometries" rel="noopener noreferrer"&gt;check_geometries&lt;/a&gt; → diagnóstico de inválidas&lt;br&gt;
├─ [NextGIS Toolbox] &lt;a href="https://toolbox.nextgis.com/t/fix_geometries" rel="noopener noreferrer"&gt;fix_geometries&lt;/a&gt; → repara auto‑intersecciones&lt;br&gt;
├─ [QGIS local] &lt;a href="https://docs.qgis.org/3.22/en/docs/user_manual/processing_algs/qgis/vectorgeometry.html#snap-geometries-to-layer" rel="noopener noreferrer"&gt;snapgeometries&lt;/a&gt; → cierra gaps (mueve vértices)&lt;br&gt;
└─ [QGIS local] &lt;a href="https://docs.qgis.org/3.34/en/docs/user_manual/processing_algs/qgis/vectorgeometry.html#fix-geometries" rel="noopener noreferrer"&gt;fixgeometries&lt;/a&gt; → limpia residuos de validez&lt;/p&gt;

&lt;p&gt;Capa final (+12k polígonos válidos + aristas coincidentes)&lt;/p&gt;
&lt;h3&gt;
  
  
  Esquema del flujo de trabajo
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fzxscizw91xex0az3udnl.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fzxscizw91xex0az3udnl.png" alt="Esquema del flujo de trabajo" width="799" height="358"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;¿Por qué este orden?&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Primero validar, porque un snap sobre geometrías inválidas puede producir resultados impredecibles o introducir nuevos errores topológicos. &lt;/li&gt;
&lt;li&gt;Después del snap, algunos vértices movidos pueden crear nuevas auto‑intersecciones; &lt;code&gt;fixgeometries&lt;/code&gt; las barre.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;¿Por qué se mantienen +12000 features?&lt;/strong&gt;&lt;br&gt;
Las herramientas &lt;code&gt;snapgeometries&lt;/code&gt; y &lt;code&gt;fixgeometries&lt;/code&gt; editan geometrías &lt;em&gt;en el lugar&lt;/em&gt;: no parten ni fusionan features (a diferencia de otras aplicaciones como &lt;code&gt;v.clean&lt;/code&gt;, que genera nuevos nodos, divide las aristas y multiplica los registros).&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;&lt;em&gt;Nota&lt;/em&gt;&lt;/strong&gt;: &lt;em&gt;En los GIS, 'snap' (o 'snapping') es el proceso de ajustar o 'pegar' los vértices de una geometría a los vértices o aristas más cercanos de otra geometría, siempre que estén dentro de una distancia máxima (tolerancia).&lt;/em&gt;&lt;/p&gt;


&lt;h2&gt;
  
  
  El código: &lt;code&gt;antigaps.py&lt;/code&gt;
&lt;/h2&gt;

&lt;p&gt;El script se encuentra en &lt;a href="https://github.com/matkoclaudio/antigaps" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;. Acá profundizo en las partes más relevantes.&lt;/p&gt;
&lt;h3&gt;
  
  
  1. Parámetros de entrada
&lt;/h3&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;
&lt;span class="n"&gt;TU_API_KEY&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sh"&gt;''&lt;/span&gt; &lt;span class="c1"&gt;# API key de NextGIS Toolbox (*)
&lt;/span&gt;&lt;span class="n"&gt;RUTA&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sh"&gt;''&lt;/span&gt;       &lt;span class="c1"&gt;# Ruta de la capa (vacío → selector gráfico)
&lt;/span&gt;&lt;span class="n"&gt;GAPS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;20&lt;/span&gt;       &lt;span class="c1"&gt;# Ancho típico de los gaps (tolerancia de snap)
&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;(*) Para obtener una API key de NextGIS Toolbox, basta con obtener una cuenta de usuario en &lt;a href="https://my.nextgis.com/" rel="noopener noreferrer"&gt;my.nextgis.com&lt;/a&gt;. Luego logueado en &lt;a href="https://toolbox.nextgis.com/" rel="noopener noreferrer"&gt;toolbox.nextgis.com&lt;/a&gt; seleccionar cualquier herramienta y clic en el botón &lt;code&gt;code&lt;/code&gt;, allí:&lt;br&gt;
&lt;br&gt;
 &lt;code&gt;toolbox = ToolboxClient('xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx')&lt;/code&gt;&lt;br&gt;
&lt;/p&gt;

&lt;p&gt;La API key se puede proporcionar mediante variable de entorno &lt;code&gt;TOOLBOX_API_KEY&lt;/code&gt; o archivo &lt;code&gt;~/.toolbox_key&lt;/code&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. Selección de capa (con o sin GUI)
&lt;/h3&gt;

&lt;p&gt;El script usa &lt;code&gt;tkinter&lt;/code&gt; si está disponible (selector gráfico). Otra opción es utilizar la ruta por consola. Esto lo hace versátil para entornos de escritorio o servidores.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. Paso en la nube (NextGIS Toolbox SDK)
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;
&lt;span class="n"&gt;toolbox&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;ToolboxClient&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;API_KEY&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="c1"&gt;# Diagnóstico
&lt;/span&gt;&lt;span class="n"&gt;check&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;toolbox&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;tool&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;check_geometries&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)({&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;input_file&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;toolbox&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;upload_file&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;CAPA&lt;/span&gt;&lt;span class="p"&gt;)})&lt;/span&gt;
&lt;span class="n"&gt;toolbox&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;download_results&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;check&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;CARPETA&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="c1"&gt;# Reparación
&lt;/span&gt;&lt;span class="n"&gt;tarea&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;toolbox&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;tool&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;fix_geometries&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;submit&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;input_file&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;toolbox&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;upload_file&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;CAPA&lt;/span&gt;&lt;span class="p"&gt;)})&lt;/span&gt;
&lt;span class="n"&gt;fixed&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;tarea&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;wait_for_completion&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;timeout&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;3600&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;poll_interval&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;15&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="n"&gt;toolbox&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;download_results&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;fixed&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;CARPETA&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;check_geometries&lt;/code&gt; genera dos archivos: &lt;code&gt;errors.csv&lt;/code&gt; y &lt;code&gt;errors.geojson&lt;/code&gt;.&lt;br&gt;
&lt;code&gt;fix_geometries&lt;/code&gt; devuelve &lt;code&gt;fixed.gpkg&lt;/code&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  4. Paso local (QGIS headless)
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;
&lt;span class="n"&gt;subprocess&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;run&lt;/span&gt;&lt;span class="p"&gt;([&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;qgis_process&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;run&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;native:snapgeometries&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;--&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;INPUT=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;CAPA&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;REFERENCE_LAYER=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;CAPA&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;TOLERANCE=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;TOL_SNAP&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;BEHAVIOR=0&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;OUTPUT=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;GPKG_SNAP&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="n"&gt;check&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="bp"&gt;True&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="n"&gt;subprocess&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;run&lt;/span&gt;&lt;span class="p"&gt;([&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;qgis_process&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;run&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;native:fixgeometries&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;--&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;INPUT=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;GPKG_SNAP&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;OUTPUT=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;FINAL&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="n"&gt;check&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="bp"&gt;True&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;El parámetro &lt;strong&gt;BEHAVIOR&lt;/strong&gt; define la estrategia de ajuste del algoritmo. En este script usamos &lt;code&gt;BEHAVIOR=0&lt;/code&gt;, que es el modo por defecto: mueve cada vértice al punto más cercano (nodo o segmento) dentro de la tolerancia, e inserta nuevos vértices si es necesario. Es el comportamiento más adecuado para cerrar gaps entre polígonos. Para otros casos, la herramienta ofrece hasta 7 modos distintos (ver tabla). El resultado intermedio es &lt;code&gt;snap.gpkg&lt;/code&gt;; el final, &lt;code&gt;resultado.gpkg&lt;/code&gt;.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Valor&lt;/th&gt;
&lt;th&gt;Descripción&lt;/th&gt;
&lt;th&gt;¿Cuándo usarlo?&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;0&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Mueve los vértices al punto más cercano (nodo o segmento). Si es necesario, &lt;strong&gt;inserta nuevos vértices&lt;/strong&gt; en el segmento para ajustar la geometría.&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;El más común.&lt;/strong&gt; Ideal para cerrar gaps y alinear geometrías complejas.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;1&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Mueve los vértices al punto más cercano, pero &lt;strong&gt;no inserta nuevos vértices&lt;/strong&gt; en los segmentos.&lt;/td&gt;
&lt;td&gt;Para minimizar cambios en la estructura de vértices.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;2&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Prioriza alinear con &lt;strong&gt;nodos existentes&lt;/strong&gt; (vértices de referencia). Si no hay nodo cerca, usa el segmento más cercano. Inserta vértices si es necesario.&lt;/td&gt;
&lt;td&gt;Para respetar los vértices originales de la referencia.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;3&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Prioriza alinear con nodos existentes, pero &lt;strong&gt;no inserta nuevos vértices&lt;/strong&gt;.&lt;/td&gt;
&lt;td&gt;Para mover vértices solo a otros vértices, sin crear nuevos.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;4&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;Solo mueve los vértices extremos&lt;/strong&gt; (inicio y fin de cada línea). Prioriza alinear con nodos.&lt;/td&gt;
&lt;td&gt;Ideal para líneas (no polígonos) o para conectar extremos de caminos.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;5&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Solo mueve vértices extremos, priorizando el punto más cercano (nodo o segmento).&lt;/td&gt;
&lt;td&gt;Similar al 4, pero más flexible.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;6&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Engancha solo a &lt;strong&gt;nodos ancla&lt;/strong&gt; de la misma capa.&lt;/td&gt;
&lt;td&gt;Caso muy específico para redes o topología compleja.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;7&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Engancha a nodos ancla de &lt;strong&gt;cualquier capa&lt;/strong&gt;.&lt;/td&gt;
&lt;td&gt;Similar al 6, pero con varias capas de referencia.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h3&gt;
  
  
  Archivos de salida: ¿qué hace cada uno?
&lt;/h3&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Archivo&lt;/th&gt;
&lt;th&gt;Origen&lt;/th&gt;
&lt;th&gt;Contenido&lt;/th&gt;
&lt;th&gt;Utilidad&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;a href="https://raw.githubusercontent.com/matkoclaudio/antigaps/main/data/input/poligonos.gpkg" rel="noopener noreferrer"&gt;errors.csv&lt;/a&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;check_geometries&lt;/code&gt; (toolbox.nextgis)&lt;/td&gt;
&lt;td&gt;Tabla con índices (&lt;code&gt;num&lt;/code&gt;) y coordenadas de cada auto‑intersección.&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;Diagnóstico&lt;/strong&gt;: saber qué polígonos están mal dibujados y en qué punto exacto.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;a href="https://raw.githubusercontent.com/matkoclaudio/antigaps/main/data/input/errors.geojson" rel="noopener noreferrer"&gt;errors.geojson&lt;/a&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;check_geometries&lt;/code&gt; (toolbox.nextgis)&lt;/td&gt;
&lt;td&gt;Los mismos errores representados como puntos georreferenciados (FeatureCollection de &lt;code&gt;Point&lt;/code&gt;).&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;Visualización&lt;/strong&gt;: cargar en QGIS para localizar espacialmente las zonas problemáticas.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;a href="https://raw.githubusercontent.com/matkoclaudio/antigaps/main/data/input/fixed.gpkg" rel="noopener noreferrer"&gt;fixed.gpkg&lt;/a&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;fix_geometries&lt;/code&gt; (toolbox.nextgis)&lt;/td&gt;
&lt;td&gt;Capa completa con las geometrías inválidas reparadas (auto‑intersecciones convertidas en multipolígonos válidos).&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;Base intermedia&lt;/strong&gt;: capa limpia en cuanto a validez OGC, aunque los gaps persisten.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;a href="https://raw.githubusercontent.com/matkoclaudio/antigaps/main/data/input/snap.gpkg" rel="noopener noreferrer"&gt;snap.gpkg&lt;/a&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;snapgeometries&lt;/code&gt; (qgis_process)&lt;/td&gt;
&lt;td&gt;Capa con los vértices pegados dentro de la tolerancia; los gaps quedan cerrados.&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;Archivo de depuración&lt;/strong&gt;: útil para inspeccionar cómo ha actuado el snap antes de la limpieza final.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;a href="https://raw.githubusercontent.com/matkoclaudio/antigaps/main/data/input/resultado.gpkg" rel="noopener noreferrer"&gt;resultado.gpkg&lt;/a&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;fixgeometries&lt;/code&gt; (qgis_process)&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;Capa final&lt;/strong&gt;: geometrías válidas + aristas perfectamente coincidentes (sin gaps).&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;El entregable&lt;/strong&gt;: es el archivo que debes usar para tus análisis posteriores.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h3&gt;
  
  
  La tolerancia: el parámetro + crítico
&lt;/h3&gt;

&lt;p&gt;&lt;code&gt;TOLERANCE&lt;/code&gt; (la variable &lt;code&gt;GAPS&lt;/code&gt; del script) es la distancia máxima que el snap considera para mover un vértice. Actúa como un umbral:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Si la tolerancia es &lt;strong&gt;menor&lt;/strong&gt; que el gap → el algoritmo no detecta los bordes cercanos y el gap persiste.&lt;/li&gt;
&lt;li&gt;Si es &lt;strong&gt;igual&lt;/strong&gt; al gap → lo cierra justo.&lt;/li&gt;
&lt;li&gt;Si es &lt;strong&gt;mayor&lt;/strong&gt; → mueve límites que no deberían moverse, distorsionando el polígono.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;&lt;em&gt;Consejo práctico&lt;/em&gt;&lt;/strong&gt;: &lt;em&gt;mide el ancho de los gaps reales de tu capa (con herramientas de medición en QGIS), usar el valor más grande que encuentres como tolerancia.&lt;/em&gt; &lt;/p&gt;

&lt;h3&gt;
  
  
  Resultados
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F0n8fe5u7jbn3at5fp8ri.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F0n8fe5u7jbn3at5fp8ri.gif" alt="Total" width="800" height="506"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fb3sbmzpwgtmb3kccxo4b.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fb3sbmzpwgtmb3kccxo4b.gif" alt="Zoom" width="800" height="506"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  Nota sobre los datos
&lt;/h3&gt;

&lt;p&gt;Los datos de entrada utilizados corresponden a un dataset sintético, generado por un script, para pruebas, no corresponde a ninguna región real. &lt;/p&gt;

&lt;p&gt;Estos datos fueron creados mediante una cuadrícula regular a la que se le aplicaron desplazamientos aleatorios en sus vértices, generando así los gaps y las auto-intersecciones que buscamos reparar.&lt;/p&gt;

&lt;p&gt;Al ser artificial, contiene errores topológicos controlados que permiten demostrar el flujo de trabajo de forma clara y reproducible. &lt;/p&gt;

&lt;p&gt;En tu propia capa de datos reales, el script debería funcionar exactamente igual, sólo no olvides de ajustar la tolerancia a tu caso (TOL_SNAP).&lt;/p&gt;

&lt;p&gt;Tanto los datos de &lt;a href="https://github.com/matkoclaudio/antigaps/tree/main/data/input" rel="noopener noreferrer"&gt;entrada&lt;/a&gt; como los &lt;a href="https://github.com/matkoclaudio/antigaps/tree/main/data/output" rel="noopener noreferrer"&gt;resultados&lt;/a&gt; se encuentran a disposición en el repositorio, para poder ensayar el uso del script sin problemas.&lt;/p&gt;

&lt;p&gt;Este pipeline puede ser útil en diversos escenarios: Catastro y ordenamiento territorial; Planificación urbana; Análisis de cobertura de suelo; Migración de datos heredados; entre otros.&lt;/p&gt;

&lt;h3&gt;
  
  
  Mejoras futuras
&lt;/h3&gt;

&lt;p&gt;El script actual es funcional, pero como todo puede mejorar. Próximos pasos: Medición automática de gaps; Eliminación de superposiciones; Validación final y Logs estructurados para depuración y seguimiento. Con estas mejoras, el script se convertiría en un pipeline CI/CD para datos espaciales, más completo y automatizado.&lt;/p&gt;

&lt;h3&gt;
  
  
  Requisitos para replicar esta solución
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.python.org/" rel="noopener noreferrer"&gt;Python 3.6+&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://qgis.org/" rel="noopener noreferrer"&gt;QGIS Desktop&lt;/a&gt; &lt;/li&gt;
&lt;li&gt;
&lt;a href="https://pypi.org/project/toolbox-sdk/" rel="noopener noreferrer"&gt;NextGIS Toolbox SDK&lt;/a&gt; &lt;/li&gt;
&lt;li&gt;&lt;a href="https://toolbox.nextgis.com/" rel="noopener noreferrer"&gt;API key de toolbox.nextgis.com&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Reflexiones finales
&lt;/h3&gt;

&lt;p&gt;Vimos cómo combinar herramientas en la nube y locales con Python nos permite resolver problemas topológicos complejos de forma automatizada. El pipeline parte de una capa con gaps y bordes no coincidentes (sin coalición). El resultado es una capa donde los bordes adyacentes comparten exactamente los mismos vértices, eliminando gaps y logrando una buena coalición entre polígonos. &lt;/p&gt;

&lt;h3&gt;
  
  
  Claves:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Comprender la naturaleza de cada error (validez vs. topología).&lt;/li&gt;
&lt;li&gt;Aplicar las herramientas en el orden correcto.&lt;/li&gt;
&lt;li&gt;Elegir una tolerancia adecuada.&lt;/li&gt;
&lt;li&gt;Mantener el mismo número de features, no romper la integridad de la capa.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;El resultado es una capa lista para análisis posteriores, y todo con menos de 100 líneas de Python.&lt;/p&gt;

&lt;h3&gt;
  
  
  Enlaces
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Repositorio del script en GitHub&lt;br&gt;
&lt;a href="https://github.com/matkoclaudio/antigaps" rel="noopener noreferrer"&gt;https://github.com/matkoclaudio/antigaps&lt;/a&gt;&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Documentación de QGIS Processing&lt;br&gt;
&lt;a href="https://docs.qgis.org/" rel="noopener noreferrer"&gt;https://docs.qgis.org/&lt;/a&gt;&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;SDK de NextGIS Toolbox&lt;br&gt;
&lt;a href="https://nextgis.es/blog/nextgis-toolbox-sdk/" rel="noopener noreferrer"&gt;https://nextgis.es/blog/nextgis-toolbox-sdk/&lt;/a&gt;&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;NextGIS Toolbox SDK&lt;br&gt;
&lt;a href="https://toolbox.nextgis.com/" rel="noopener noreferrer"&gt;https://toolbox.nextgis.com/&lt;/a&gt;&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>geoinformatics</category>
      <category>topology</category>
      <category>qgis</category>
      <category>nextgis</category>
    </item>
  </channel>
</rss>
