Teselas vectoriales y PMTiles: publique una versión del mapa
Cuándo usar un archivo de teselas, cómo probar HTTP Range y dónde mantener las consultas.
Revisión editorial: 2026-09-23
Elija el contrato de lectura
PMTiles empaqueta teselas en un archivo que los clientes pueden consultar por rangos HTTP. Es útil para distribuir una versión de cartografía relativamente estable. No sustituye una base editable, una API de consulta por atributos ni los permisos por entidad. Mantenga el dato maestro en su sistema de edición y publique un derivado con atributos permitidos.
Prepare una versión pequeña
Seleccione un conjunto de datos que pueda redistribuir. Documente fecha, licencia, CRS y campos incluidos. Genere teselas con la herramienta compatible elegida siguiendo su documentación; registre su versión y los parámetros de simplificación y zoom. No existe un comando universal para todos los productores de PMTiles.
Compruebe el archivo local con pmtiles show mapa.pmtiles usando la CLI oficial instalada. Revise tipo de tesela, niveles de zoom y nombres de capas. El nombre de la capa vectorial interna debe coincidir con source-layer en el estilo MapLibre; el nombre del archivo no lo reemplaza.
Verifique el almacenamiento
Suba primero a un entorno de prueba que soporte solicitudes Range. Sustituya la URL por la de su archivo de prueba y ejecute:
curl --fail --range 0-126 --dump-header headers.txt --output first-bytes.bin 'https://maps.example.org/releases/mapa.pmtiles'
El dominio es ilustrativo: no es un servicio de GeoSAT. Espere una respuesta parcial HTTP 206 y un Content-Range coherente. Confirme CORS desde el origen real del visor. Si el servidor devuelve todo el archivo, no lance la publicación: una vista inicial podría descargar cientos de megabytes.
Integre y mida
Use el protocolo PMTiles documentado por el cliente JavaScript, registre el protocolo antes de crear el mapa y declare cada capa del estilo. Mida bytes iniciales, tiempo hasta la primera capa y costo de egreso con caché fría y caliente. Pruebe zonas vacías y límites de zoom.
Publique con un nombre de versión inmutable y cambie el manifiesto o estilo al promoverla. Conserve la anterior para reversión. El costo debe incluir generación, almacenamiento, solicitudes, egreso y operación. Para cambios frecuentes o restricciones por usuario, compare un servicio de teselas dinámico y una API autenticada; no esconda datos privados dentro de un archivo público.
Usar un archivo para una versión publicada
PMTiles sirve cuando el mapa puede construirse como un archivo versionado de teselas y distribuirse desde almacenamiento con el comportamiento HTTP de rangos requerido. No sustituye una base editable ni una API arbitraria de entidades. Una inspección modificada no aparece en un archivo ya construido hasta producir y servir otra versión.
Separa datos autoritativos, teselas derivadas y recursos de estilo. Vincúlalos mediante una versión. Un estilo que solicita un campo eliminado puede producir un mapa incompleto sin error evidente del servidor.
Especificar el esquema antes de construir
| Decisión | Requisito de ejemplo | Validación |
|---|---|---|
| Nombre de capa | assets en el archivo | Coincide exactamente con source-layer |
| Identificador | asset_id estable | La selección abre el registro correcto |
| Propiedades incluidas | Solo tipo y condición | No hay datos privados en teselas decodificadas |
| Escalas | Adecuadas a la tarea pública | Vista general y operacional utilizables |
| Simplificación | Política exclusiva de visualización | El detalle usa geometría autoritativa |
| Atribución | Fuente y licencia | Visible en mapa y documentada |
No copies todos los atributos de la base. Las teselas son datos descargables aunque la interfaz oculte propiedades. Decide si la geometría puede publicarse antes de optimizar peso.
Comprobar rangos HTTP reales
Sigue la configuración del proveedor y verifica respuestas parciales desde el archivo publicado. Descargarlo completo no basta. Comprueba estado, rango de contenido, caché y cabeceras de origen cruzado desde el origen de la aplicación. Evita proxies que eliminen rangos o compriman de forma incompatible.
Registra el protocolo PMTiles antes de cargar el estilo MapLibre que lo referencia. Inspecciona nombres reales de capas. Sigue la integración oficial con MapLibre para las versiones instaladas y empaqueta dependencias de manera consistente.
Validar antes de cambiar la referencia pública
- Construye desde una versión inmutable e identifica origen y salida.
- Inspecciona metadatos y teselas representativas en zonas densas y dispersas.
- Abre una vista previa con estilos, fuentes y sprites previstos.
- Comprueba claves, atribución, zoom y un punto cerca del límite.
- Publica con URL versionada y cambia la referencia después de validar.
- Conserva archivo y estilo anteriores durante una ventana acotada de rollback.
Los nombres versionados ayudan a evitar datos viejos en caché con estilos nuevos. Si falla la publicación, recupera la referencia anterior y conserva el archivo rechazado para diagnosticar. No sobrescribas la única copia funcional antes de revisar el reemplazo.
Comparar el costo completo
Cuenta construcción, almacenamiento, solicitudes, transferencia, caché y trabajo operacional. Un archivo puede simplificar el servicio, pero reconstrucciones frecuentes o descargas grandes pueden dominar ciertos casos. Mide frecuencia y audiencia; no prometas alojamiento gratuito.
Para registros cambiantes, combina teselas de orientación con una API de entidades para detalle actual. Expón la versión cuando la desactualización pueda afectar una decisión. El laboratorio demuestra separación de datos y API; no es un benchmark de distribución de teselas en producción.
Fuentes y documentación
Siguiente paso
Continúe en la colección Open GIS. Para comparar un proyecto concreto, use la calculadora de costo total y solicite una evaluación.