homenode.dev
Artículos

Protomaps: mapas bajo tu control con un archivo PMTiles

Cómo servir mapas propios con Protomaps y PMTiles, qué necesitas para integrarlos y qué costes, límites y obligaciones de atribución debes tener en cuenta.

Mostrar un mapa en una aplicación parece sencillo hasta que empiezas a revisar de dónde llegan las teselas, las fuentes y los iconos. Una clave de API caducada, un cambio de precios o una conexión a internet caída pueden dejar un espacio vacío justo donde esperabas ver las calles.

Protomaps ofrece otra forma de distribuir mapas: guardar las teselas en un archivo PMTiles y servir ese archivo desde infraestructura que controles. Puede ser un servidor de tu homelab o un almacenamiento de objetos. El navegador solicita los fragmentos necesarios para mostrar la zona visible, sin descargar el archivo completo.

La idea ha vuelto a aparecer en la comunidad a raíz de esta experiencia con Protomaps. Para quienes ya mantienen servicios propios, merece una mirada: reduce algunas dependencias, aunque no elimina la necesidad de administrar datos, infraestructura y licencias.

Qué guarda PMTiles

Un mapa interactivo suele dividirse en pequeñas piezas llamadas teselas. La aplicación selecciona cuáles necesita según la posición y el nivel de zoom. PMTiles reúne esas teselas y un índice en un solo archivo.

Cuando el cliente necesita una zona, consulta el índice y usa peticiones HTTP con cabecera Range para recuperar únicamente los segmentos correspondientes. Por eso, el servidor o almacenamiento elegido debe admitir peticiones de rango. La documentación de Protomaps explica este requisito y la configuración de acceso desde el navegador.

Una ventaja práctica es que no necesitas mantener un servicio de generación de teselas en cada petición: puedes preparar el archivo de antemano y servirlo como contenido estático. El compromiso es que ese archivo representa una instantánea. Los cambios posteriores en los datos originales no aparecerán hasta que actualices el archivo.

Cuándo tiene sentido

PMTiles encaja bien cuando quieres mostrar una región conocida en una aplicación, un panel de Home Assistant o un servicio interno y prefieres controlar dónde se alojan los datos. Una zona limitada también permite empezar con menos almacenamiento y revisar el flujo antes de plantearte una cobertura mayor.

Puede ser menos adecuado si necesitas datos actualizados constantemente, mapas de todo el mundo sin encargarte de sus actualizaciones o servicios adicionales integrados. El archivo de teselas resuelve la distribución del mapa base; no proporciona por sí solo búsqueda de direcciones, cálculo de rutas ni navegación. Cada función requiere su propia fuente de datos o servicio.

Preparar tu primer mapa

Un recorrido razonable para probarlo sería el siguiente:

  1. Descarga o prepara un mapa base. Protomaps publica archivos de mapas base construidos a partir de OpenStreetMap. Comprueba qué cobertura y niveles de zoom necesitas.
  2. Limita la región. La herramienta de línea de comandos de PMTiles incluye una función de extracción para generar un archivo más ajustado a tu zona. Consulta la documentación de la CLI para elegir los parámetros apropiados.
  3. Publica el archivo. Puedes usar almacenamiento de objetos compatible con peticiones de rango o un servidor HTTP bajo tu control. Si el mapa y el archivo se sirven desde orígenes diferentes, configura CORS para el navegador.
  4. Añade un visor. MapLibre GL puede mostrar el mapa con soporte para PMTiles y un estilo compatible. Ajusta el centro, el zoom y la atribución para tu aplicación.
  5. Comprueba todas las dependencias. El estilo puede cargar fuentes y sprites —los recursos gráficos de símbolos e iconos— desde otras direcciones. Si quieres que el mapa funcione sin esos servicios externos, alójalos también y actualiza sus rutas.
  6. Planifica las actualizaciones. Decide cada cuánto reemplazarás la instantánea, cómo validarás el nuevo archivo y qué copia conservarás para volver atrás si algo falla.

Antes de darlo por terminado, abre las herramientas de desarrollo del navegador y revisa las peticiones de red. Así podrás detectar recursos externos inesperados, errores CORS o un servidor que no responda correctamente a las peticiones de rango.

Servidor propio o almacenamiento de objetos

Un servidor en casa te da control directo sobre el archivo y resulta cómodo para una aplicación accesible solo en la red local. A cambio, la disponibilidad depende de tu equipo, tu conexión y tu configuración. Si expones el servicio a internet, también tendrás que ocuparte del acceso y del mantenimiento.

El almacenamiento de objetos evita mantener ese servidor concreto y permite servir el archivo desde un proveedor compatible. En ese caso sigues gestionando los datos, pero dependes de la disponibilidad y las condiciones del proveedor. Según la configuración, puede ser útil añadir una caché o CDN.

La alternativa gestionada es contratar un servicio de mapas que entregue teselas y, en algunos casos, búsqueda o rutas. Reduce trabajo operativo, pero añade dependencia de su API y sus condiciones. La elección depende de qué necesitas controlar y de cuánto mantenimiento quieres asumir.

Los costes no desaparecen

Los datos abiertos y las herramientas de código abierto no convierten automáticamente el despliegue en gratuito. Conviene revisar al menos:

  • Almacenamiento: tamaño del archivo, copias de seguridad y espacio para preparar nuevas versiones.
  • Transferencia y peticiones: volumen de tráfico y número de solicitudes. En almacenamiento de objetos, las peticiones de rango pueden computar como operaciones facturables.
  • Infraestructura: servidor, electricidad, conexión, almacenamiento o CDN, según dónde lo alojes.
  • Mantenimiento: preparación de extractos, actualizaciones y supervisión.

No hay un coste universal: depende de la región, el detalle, el uso real y el proveedor. Empieza con una zona pequeña y mide tus propias peticiones y transferencia antes de calcular una instalación mayor.

También conviene distinguir una política CORS de un control de acceso: CORS regula qué pueden hacer los navegadores entre orígenes, pero no impide por sí solo que otro cliente solicite una URL pública. La guía de seguridad y privacidad de Protomaps explica esta diferencia.

Atribución y licencias

Alojar el mapa tú mismo no elimina las obligaciones sobre sus datos. Si utilizas datos de OpenStreetMap, debes mostrar la atribución correspondiente e indicar que están disponibles bajo la licencia ODbL; en un mapa web, normalmente puedes enlazar a la página de derechos de OpenStreetMap. Revisa sus directrices para el formato concreto de tu aplicación.

Las fuentes tipográficas, los sprites o las imágenes pueden tener condiciones propias. Comprueba las licencias y atribuciones de cada recurso que distribuyas. Si distribuyes datos derivados, revisa también las obligaciones de la ODbL aplicables a tu caso.

Protomaps ofrece una pieza interesante para una aplicación que necesita mostrar un mapa bajo control propio. Una extracción regional, un servidor que admita Range y un visor como MapLibre permiten empezar a evaluar si ese control compensa el mantenimiento.

Fuentes