Un visor de MBTiles vectoriales que funciona en tu navegador
Un archivo MBTiles es un mapa en teselas completo dentro de un solo archivo. Dentro hay una pequeña base de datos SQLite: una tabla con las teselas y otra con información sobre ellas. Los MBTiles vectoriales contienen Mapbox Vector Tiles, teselas binarias compactas con carreteras, edificios, ríos, límites y sus atributos, listas para que una app de mapas les dé estilo. Se crean con herramientas como tippecanoe, Planetiler, OpenMapTiles y QGIS, y están detrás de muchos mapas MBTiles offline y autoalojados.
El problema llega cuando quieres mirar dentro. Tu ordenador no sabe abrir el archivo, los visores de imágenes no ven nada y la mayoría de los visores online solo muestran teselas ráster. Para ver un MBTiles vectorial normalmente necesitas un servidor de teselas, un estilo y algo de JavaScript, o un programa SIG completo. Este visor de MBTiles vectoriales online se salta todo eso: suelta el archivo y lee la base de datos, decodifica las teselas vectoriales en tu navegador y dibuja cada capa en el mapa con su propio color.
Está pensado tanto para revisar como para ver. Puedes hacer clic en cualquier objeto para leer sus atributos, activar y desactivar capas, ver cuánto pesan las teselas en cada nivel de zoom y cuáles son las más grandes, y revisar el archivo según las especificaciones de MBTiles y de teselas vectoriales. Al terminar, exporta los objetos de la vista como GeoJSON, guarda un PNG del mapa o descarga un informe técnico para un compañero o un cliente. Mi opinión: pasa la revisión antes de subir un tileset a un servidor. La mayoría de los problemas de «mi mapa sale en blanco» son una fila de metadatos que falta o un rango de zoom equivocado, y es mucho más fácil corregirlos antes de publicar.
Qué hace el visor de MBTiles vectoriales
Esto es todo lo que hace la herramienta, en el orden en que te lo encontrarás.
- Abre el archivo. Arrastra un archivo .mbtiles al mapa o pulsa «Abrir MBTiles». Los archivos de hasta 300 MB se abren en el navegador con el motor SQLite sql.js. «Probar un ejemplo» carga un pequeño tileset mundial con países, lagos, ríos y ciudades para que veas la herramienta en marcha enseguida.
- Ve el mapa al instante. La herramienta lee la extensión y el centro de los metadatos y se acerca a los datos. Cada capa se dibuja en un canvas con su propio color: polígonos como rellenos claros, líneas como trazos y puntos como círculos. Los nombres de capa habituales como water, landuse, building, transportation y place reciben colores naturales.
- Trabaja con las capas. La pestaña Capas lista cada capa de los metadatos y de las teselas con sus tipos de geometría, el número de objetos de una muestra y todos sus campos con un valor de ejemplo. Activa y desactiva capas, pulsa «Solo» para ver una capa sola o haz clic en el cuadrado de color para elegir tu propio color.
- Haz clic para inspeccionar objetos. Haz clic en el mapa y una tarjeta muestra cada objeto en ese punto en las capas visibles: capa, tipo de geometría, ID y todos los atributos. El objeto se resalta en el mapa, y puedes copiarlo como GeoJSON o descargar la tesela completa como archivo .pbf.
- Lee la información del archivo. La pestaña Archivo muestra los metadatos en palabras claras: nombre, descripción, atribución, versión, formato, compresión, rango de zoom, extensión, centro, el generador (por ejemplo tippecanoe) y el tamaño del archivo y de los datos de teselas.
- Revisa las teselas. La pestaña Teselas da el número de teselas, el tamaño total, medio y máximo por nivel de zoom y las diez teselas más grandes del archivo. Pulsa «Ver» para ir a una tesela. La cuadrícula de teselas dibuja cada borde con su z/x/y y su tamaño.
- Pasa la revisión. La pestaña Revisión comprueba el archivo: tabla tiles, metadatos, formato, compresión, la lista vector_layers de json, capas que faltan en los metadatos, extensión, centro, el rango de zoom frente a las teselas reales, teselas de más de 500 KB y atribución. Cada comprobación aparece como correcta, aviso o error, con una explicación sencilla.
- Acércate más allá de los datos. Las teselas vectoriales siguen nítidas cuando te acercas más allá del último nivel de zoom, así que el visor sigue dibujando las teselas más profundas ampliadas («overzoom»). Por debajo del primer nivel, un aviso te pide que te acerques.
- Ajusta la visualización. Cambia la opacidad del relleno y el grosor de línea, activa o desactiva las etiquetas de lugares y añade un mapa de calles o de satélite para orientarte. Sin mapa base no se carga nada de otros servidores.
- Exporta. Descarga los objetos visibles como GeoJSON, la vista del mapa como PNG, los metadatos como JSON o un informe técnico con las comprobaciones, capas, campos, estadísticas de teselas y recomendaciones.
El archivo se lee con JavaScript y WebAssembly dentro de la pestaña de tu navegador. Nunca se sube, así que el visor es seguro para datos privados o con licencia.
Cómo ver un archivo MBTiles vectorial, paso a paso
Un ejemplo real con el tileset mundial de ejemplo (datos de Natural Earth, zoom 0 a 5).
La herramienta se abre con un mapa vacío y una zona para soltar archivos. Arrastra tu archivo .mbtiles, haz clic para elegir uno o pulsa «Probar un ejemplo».
El visor lee la base de datos SQLite, se acerca a la extensión y dibuja las cuatro capas: países como rellenos grises, lagos en azul, ríos como líneas azules y ciudades como puntos rojos con etiquetas.
La pestaña Capas lista cada capa con su geometría, los objetos encontrados en una muestra y cada campo con un valor de ejemplo. Aquí solo están activados los ríos y las ciudades, con la vista sobre Europa.
Haz clic en una ciudad. La tarjeta muestra su capa, tipo de geometría, ID y todos sus atributos, y el objeto se resalta. Puedes copiarlo como GeoJSON o descargar la tesela de la que procede.
La pestaña Archivo convierte la tabla metadata en datos claros: nombre, atribución, formato, compresión gzip, zoom 0 a 5, extensión, centro y tamaño del archivo.
La pestaña Teselas muestra teselas y tamaños por nivel de zoom y las teselas más grandes. Con la cuadrícula activada, cada borde de tesela se dibuja con su z/x/y y su tamaño guardado.
La pestaña Revisión comprueba el archivo según las reglas de MBTiles y de teselas vectoriales. El ejemplo supera todas las comprobaciones; un archivo real suele mostrar uno o dos avisos, cada uno con su explicación.
El informe técnico reúne en una página el resumen, una vista previa del mapa, las comprobaciones, los metadatos, cada capa y campo, las estadísticas de teselas y recomendaciones. Imprímelo o guárdalo como PDF.
Cómo abrir un archivo MBTiles: tus opciones
Hay varias formas de abrir un archivo MBTiles. La adecuada depende de si solo quieres mirarlo, revisarlo o usarlo en un proyecto.
- En tu navegador, con este visor. La forma más rápida de ver qué hay dentro de un archivo vectorial: sin instalar nada, sin servidor, en Windows, Mac, Linux y tabletas. Ideal para revisar un tileset, leer atributos y compartir un informe. Para MBTiles ráster (teselas PNG, JPEG, WebP) usa el visor de MBTiles de este sitio.
- En QGIS. QGIS 3.14 y posteriores abren MBTiles vectoriales directamente: arrastra el archivo al mapa o usa Capa → Añadir capa → Añadir capa de teselas vectoriales. Los MBTiles ráster se abren con Capa → Añadir capa → Añadir capa ráster. Útil para combinar las teselas con otros datos SIG.
- Con un servidor de teselas. TileServer GL, Martin y mbtileserver leen un archivo MBTiles y sirven sus teselas por HTTP, para que un mapa web en MapLibre GL JS, Mapbox GL JS o Leaflet pueda usarlas. Así se suelen publicar los mapas MBTiles.
- Como PMTiles. Convierte el archivo a PMTiles (hay un convertidor gratuito en este sitio) y sube ese único archivo a cualquier alojamiento estático o almacenamiento de objetos. MapLibre lo lee directamente, sin servidor de teselas.
- En el móvil o un GPS. Muchas apps de mapas offline cargan archivos MBTiles para usarlos sin conexión. Comprueba qué formato de tesela espera la app: algunas solo aceptan teselas ráster.
- Como base de datos. Como MBTiles es SQLite, también lo abren DB Browser for SQLite o la línea de comandos sqlite3. Verás las tablas y los blobs binarios, no el mapa, pero sirve para corregir una fila de metadatos.
Hay algo igual en todas partes: un archivo MBTiles lleva datos, no un estilo. Cada app decide cómo colorear las capas. Este visor elige los colores automáticamente para que veas la estructura sin escribir antes un estilo.
Cómo lee y dibuja el visor las teselas vectoriales
Abrir un MBTiles vectorial lleva cuatro pasos: leer la base de datos SQLite, encontrar la tesela correcta, descomprimirla y decodificarla, y dibujarla. Esto es exactamente lo que ocurre, con las fórmulas.
1. La base de datos MBTiles
Un archivo MBTiles es una base de datos SQLite con dos tablas obligatorias. El visor la carga en memoria con sql.js, una versión de SQLite compilada a WebAssembly, y ejecuta consultas SQL normales:
CREATE TABLE metadata (name text, value text);
CREATE TABLE tiles (zoom_level integer, tile_column integer,
tile_row integer, tile_data blob);
filas de metadata: name, format = pbf, minzoom, maxzoom, bounds,
center, attribution, description, json, …
estadísticas: SELECT zoom_level, COUNT(*), SUM(LENGTH(tile_data)),
MAX(LENGTH(tile_data)) FROM tiles GROUP BY zoom_levelAlgunos archivos guardan tiles como una vista sobre dos tablas (map e images), para que las teselas idénticas, como el océano vacío, se guarden una sola vez. El visor maneja las dos estructuras y te dice cuál usa tu archivo.
2. De la posición en el mapa a la fila de la tesela: la inversión TMS
Un mapa web numera las teselas desde arriba (la fila 0 está al norte). MBTiles sigue el esquema TMS, más antiguo, y numera las filas desde abajo. Por eso cada petición de tesela invierte la fila:
n = 2^z teselas por lado en el zoom z x = ⌊(λ + 180) / 360 × n⌋ y = ⌊(1 − ln(tan φ + sec φ) / π) / 2 × n⌋ fila del mapa web (desde el norte) tile_row = n − 1 − y fila de MBTiles (desde el sur) ejemplo z = 5, x = 16, y = 10 → tile_row = 32 − 1 − 10 = 21
Olvidar esta inversión es el error más común en los lectores de MBTiles caseros: el mapa muestra entonces el hemisferio sur donde debería estar el norte. Si tu propia app dibuja los datos al revés o en otro lugar, revisa esto primero.
3. Descomprimir la tesela
Las teselas vectoriales casi siempre están comprimidas. El visor lee los primeros bytes de la tesela para saber cómo y la descomprime con el DecompressionStream integrado en el navegador:
1F 8B … gzip (la mayoría: tippecanoe, Planetiler, OpenMapTiles) 78 01/5E/9C/DA zlib (algunas herramientas antiguas) cualquier otro sin comprimir 89 50 4E 47 PNG ┐ FF D8 JPEG ├ teselas ráster: no es un archivo vectorial 52 49 46 46 WebP ┘
La misma comprobación detecta los MBTiles ráster aunque sus metadatos estén mal, y te lleva al visor ráster en lugar de mostrar un mapa vacío.
4. Decodificar el protobuf
Una Mapbox Vector Tile es un mensaje de Protocol Buffers. Los números se guardan como varints: 7 bits por byte, y el 8.º bit indica «siguen más bytes». Los valores con signo usan codificación zigzag para que los números negativos pequeños sigan siendo cortos:
varint 300 = 1010 1100 0000 0010 → 0101100 + 0000010 × 128 = 300
zigzag 0 → 0, −1 → 1, 1 → 2, −2 → 3, 2 → 4
decodificar: n = (z >>> 1) ^ −(z & 1)
Tile { layers = 3 }
Layer { name = 1, features = 2, keys = 3, values = 4, extent = 5, version = 15 }
Feature { id = 1, tags = 2, type = 3, geometry = 4 }
tags [índice de clave, índice de valor, índice de clave, índice de valor, …]Los nombres y valores de los atributos se guardan una sola vez por capa, en las listas keys y values. Cada objeto solo guarda pares de índices, por eso las teselas vectoriales son tan compactas. El decodificador del visor está escrito a partir de la especificación y se probó contra el decodificador de referencia de Mapbox con más de 350.000 objetos sin ninguna diferencia.
5. Comandos de geometría
La geometría es una lista de comandos. Cada entero de comando lleva un id de comando y una cantidad; los parámetros que siguen van en zigzag y son relativos al punto anterior. Las coordenadas están en unidades de tesela, de 0 a 4096 de lado a lado por defecto (el «extent»):
comando = (cantidad << 3) | id MoveTo = 1, LineTo = 2, ClosePath = 7
9 = (1 << 3) | 1 MoveTo, 1 punto
parámetros 50, 34 → +25, +17 cursor (25, 17)
18 = (2 << 3) | 2 LineTo, 2 puntos
parámetros 0, 18, 18, 0 → (25, 26), (34, 26)
15 = (1 << 3) | 7 ClosePath
anillos de polígono: área > 0 anillo exterior (sentido horario en pantalla)
área < 0 hueco
área = ½ Σ (x_j·y_i − x_i·y_j) fórmula del área de Gauss, y hacia abajoEl signo del área del anillo distingue los anillos exteriores de los huecos, así que un lago dentro de un país sigue siendo un hueco al dibujarlo y al exportarlo a GeoJSON.
6. Dibujo, escala y overzoom
Cada tesela del mapa es un canvas de 256 × 256 píxeles (512 en pantallas de alta resolución). Las unidades de tesela se escalan a píxeles, y más allá del último nivel de zoom la tesela superior se amplía y desplaza, lo que se llama overzoom:
escala = 256 × f / extent f = 2^(z_mapa − z_datos) desplazamiento = (x mod f, y mod f) × 256 parte de la tesela superior ejemplo datos hasta z 14, mapa en z 16 f = 4, escala = 256 × 4 / 4096 = 0.25 px por unidad la tesela (x, y) del mapa usa la tesela de datos (⌊x/4⌋, ⌊y/4⌋)
Como los datos son vectoriales, las líneas se vuelven a dibujar a la nueva escala y siguen nítidas, a diferencia de las teselas ráster ampliadas. Los grosores de línea y los tamaños de los puntos se dividen por la escala para que se vean igual en pantalla en cada nivel de zoom.
7. Clic en un objeto: prueba de selección
Al hacer clic, el visor busca la tesela de datos bajo el cursor, pasa el clic a unidades de tesela y prueba los objetos de las capas visibles desde la capa superior hacia abajo:
unidades por píxel = extent / (256 × 2^(z_mapa − z_datos))
punto acierto si la distancia ≤ 7 px
línea acierto si la distancia a un segmento ≤ 5 px
d² = |p − a − t(b − a)|², t = clamp(((p − a)·(b − a)) / |b − a|², 0, 1)
polígono acierto si un rayo desde el punto cruza los anillos un número impar de vecesUna prueba rápida con el rectángulo envolvente descarta la mayoría de los objetos antes de la prueba exacta, así que incluso las teselas con decenas de miles de objetos responden al instante.
8. Presupuesto de tamaño por tesela
Las teselas grandes hacen lentos los mapas: cada una se descarga, se descomprime y se decodifica antes de que se dibuje nada. tippecanoe limita las teselas a 500 KB por defecto, y ese mismo límite se usa mucho en los servicios de teselas vectoriales. El visor mide cada tesela con una sola consulta SQL y marca los niveles de zoom que lo superan:
tamaño guardado = LENGTH(tile_data) bytes, todavía comprimidos tamaño medio = SUM(tamaño) / COUNT(*) por nivel de zoom cobertura = teselas / 4^z parte de la cuadrícula mundial referencia tesela más grande < 500 KB (512.000 bytes)
En la práctica, las teselas más grandes suelen estar en un zoom intermedio sobre ciudades densas, donde se juntan muchos edificios y calles antes de que la simplificación los aclare. La lista de teselas más grandes te lleva directamente allí.
MBTiles y los formatos de exportación en detalle
Qué hay dentro de un archivo MBTiles, en qué se diferencian los MBTiles vectoriales y ráster, y qué contiene cada descarga de este visor.
MBTiles vectorial .mbtiles
Una base de datos SQLite que sigue la especificación MBTiles 1.3, con format = pbf. Cada tesela es una Mapbox Vector Tile comprimida con gzip, con una o más capas con nombre. La fila de metadatos json lista las capas y sus campos, y tippecanoe además añade tilestats con el número de objetos y valores de atributos.
metadata.json = {
"vector_layers": [
{ "id": "cities", "minzoom": 0, "maxzoom": 5,
"fields": { "name": "String", "pop_max": "Number" } } ],
"tilestats": { "layerCount": 1, "layers": [ … ] }
}Los MBTiles vectoriales ocupan poco para el área que cubren, se pueden estilizar libremente y siguen nítidos a cualquier zoom. Necesitan un renderizador (MapLibre, Mapbox GL, QGIS o este visor) y un estilo para parecer un mapa terminado.
MBTiles ráster .mbtiles
La misma estructura de base de datos, pero cada tesela es una imagen terminada (PNG, JPEG o WebP), normalmente de 256 × 256 píxeles. El estilo está fijado en los píxeles, así que el mapa se ve igual en todas partes, pero no se puede cambiar de estilo ni consultar, y se ve borroso más allá de su último nivel de zoom.
Este visor reconoce los archivos ráster por la firma de sus imágenes y te envía al visor de MBTiles ráster de este sitio, pensado para ellos.
GeoJSON (vista) .geojson
Todos los objetos de las capas visibles en las teselas que cubren la vista actual, en el nivel de zoom de datos actual, como FeatureCollection RFC 7946 en WGS84. Cada objeto conserva sus atributos y recibe dos más: _layer y _tile. Los polígonos se agrupan en Polygon o MultiPolygon con sus huecos.
{ "type": "Feature", "id": 812,
"properties": { "name": "Lyon", "pop_max": 1423000,
"_layer": "cities", "_tile": "5/16/11" },
"geometry": { "type": "Point", "coordinates": [4.8320114, 45.7578137] } }Los objetos se cortan en los bordes de las teselas, tal como están guardados, así que una carretera larga puede salir en varios trozos. Una exportación cubre como máximo 64 teselas; acércate para exportar una zona más pequeña con más detalle.
PNG (vista) .png
Una imagen de las capas vectoriales tal como las ves en la ventana del mapa, con fondo blanco, una barra de título con el nombre del archivo y el nivel de zoom, y la atribución de los metadatos.
Útil para documentación, un informe de error o una vista previa rápida para un cliente. El mapa base no se incluye, así que no hay derechos de imagen de terceros que cuidar.
Metadatos (JSON) .json
Todas las filas de la tabla metadata, con la fila json convertida en JSON real, más las estadísticas de teselas por nivel de zoom y la lista de capas encontradas en las teselas.
Útil para comparar dos versiones de un tileset o para copiar la lista vector_layers en un estilo de MapLibre.
Tesela (.pbf) .pbf
La tesela vectorial bajo tu clic, descomprimida, tal como la enviaría un servidor de teselas tras la descompresión. El nombre del archivo lleva su z/x/y.
Pásala a otras herramientas (por ejemplo vt2geojson o un visor de protobuf) para depurar una tesela en detalle.
Informe técnico .html
Una página HTML con el resumen del archivo, una vista previa del mapa, todas las comprobaciones, la tabla metadata completa, las capas con sus tipos de geometría y campos, las teselas por nivel de zoom, las teselas más grandes, recomendaciones y cómo usar el archivo.
Se imprime bien en PDF. Adjúntalo a una incidencia o envíalo con una entrega, para que quien lo reciba vea qué hay en el tileset sin abrirlo.
Todas las exportaciones se crean en tu navegador a partir del archivo abierto. No se envía nada a ningún servidor.
Quién usa un visor de MBTiles vectoriales
Las teselas vectoriales están entre los datos y el mapa, así que mucha gente distinta necesita mirar dentro.
- Desarrolladores de mapas web. Revisa un tileset antes de escribir un estilo de MapLibre o Mapbox GL: qué capas hay, cómo se llaman los campos y en qué niveles de zoom aparecen los datos. La lista de campos y los valores de ejemplo ahorran muchas suposiciones.
- Analistas SIG. Confirma que una exportación de tippecanoe, Planetiler o QGIS contiene lo que esperas, con los atributos y el rango de zoom correctos, antes de entregarla.
- DevOps y administradores de servidores de teselas. Encuentra teselas demasiado grandes, metadatos que faltan y rangos de zoom erróneos antes de desplegar en TileServer GL, Martin o una CDN, y guarda el informe como registro.
- Cartografía offline y de campo. Comprueba que los mapas MBTiles que cargas en tabletas o equipos de campo cubren la zona y los niveles de zoom correctos antes de quedarte sin cobertura.
- Compradores y revisores de datos. Mira un tileset vectorial de un proveedor sin instalar nada, recorre los atributos y devuelve el informe.
- Estudiantes y docentes. Ve cómo funcionan de verdad las teselas vectoriales: activa la cuadrícula, compara tamaños entre niveles de zoom y observa cómo el overzoom mantiene nítidas las líneas.
- Editores de datos abiertos. Verifica la atribución, la extensión y la descripción de los metadatos antes de publicar un tileset, para que los usuarios reciban un crédito y una vista inicial correctos.
- Soporte e informes de errores. Cuando un mapa muestra un hueco o un objeto roto, encuentra la tesela, descárgala como .pbf y adjúntala con el informe a la incidencia.
Preguntas frecuentes sobre MBTiles y teselas vectoriales
Las 20 preguntas más habituales sobre los archivos MBTiles y este visor.
1. ¿Qué es un archivo MBTiles?
Un archivo MBTiles es una base de datos SQLite que guarda teselas de mapa. Tiene una tabla tiles con una fila por tesela (zoom, columna, fila y los datos de la tesela) y una tabla metadata con el nombre, el formato, el rango de zoom, la extensión y otros datos. Un solo archivo puede contener un mapa en teselas completo, por eso es fácil copiarlo, compartirlo y usarlo sin conexión.
2. ¿Qué diferencia hay entre MBTiles vectorial y ráster?
Los MBTiles ráster guardan imágenes terminadas (PNG, JPEG o WebP). Los vectoriales guardan Mapbox Vector Tiles: geometría y atributos que la app de mapas estiliza y dibuja ella misma. Los vectoriales ocupan menos para la misma zona, siguen nítidos a cualquier zoom y se pueden cambiar de estilo o consultar. Mira la fila format: pbf significa vectorial.
3. ¿Cómo abro un archivo MBTiles?
Para echar un vistazo rápido a un archivo vectorial, suéltalo en este visor: sin instalar nada y sin subirlo. En QGIS 3.14 o posterior, arrastra el archivo al mapa o usa Capa → Añadir capa → Añadir capa de teselas vectoriales. Para publicarlo en una web, sírvelo con TileServer GL, Martin o mbtileserver, o conviértelo a PMTiles. La sección «Cómo abrir un archivo MBTiles» de arriba compara todas las opciones.
4. ¿Este visor de MBTiles vectoriales es gratis?
Sí. Es gratis, sin cuenta, sin límite diario de archivos y sin marca de agua en las exportaciones. Todo funciona en tu navegador, así que no hay costes de servidor.
5. ¿Se sube mi archivo a algún sitio?
No. El archivo se lee con FileReader y se abre con sql.js (SQLite en WebAssembly) dentro de la pestaña de tu navegador. Las teselas también se decodifican y dibujan allí. Solo si activas un mapa base, el navegador carga teselas de calles o satélite de esos proveedores; tu archivo se queda en tu equipo.
6. ¿Qué tamaño puede tener el archivo?
Hasta 300 MB. Toda la base de datos se carga en la memoria del navegador, así que los archivos muy grandes necesitan mucha RAM. En móviles y tabletas funcionan mejor los archivos de menos de 100 MB. Para tilesets de todo el planeta usa un servidor de teselas o QGIS.
7. ¿Por qué el mapa sale vacío al abrir el archivo?
Normalmente el mapa está por debajo del primer nivel de zoom del archivo: un tileset de una ciudad puede empezar en el zoom 10, y el visor muestra entonces un aviso para acercarte. Otras causas son unos bounds erróneos en los metadatos (el mapa va a otro sitio) o teselas ráster en el archivo. La pestaña Revisión te dice cuál es.
8. ¿Qué significa overzoom?
Un tileset tiene un último nivel de zoom, a menudo 14. Si te acercas más, el visor sigue usando las teselas del zoom 14 y las dibuja más grandes. Como los datos vectoriales se redibujan, las líneas siguen nítidas. Por eso muchos mapas base terminan en el zoom 14: las teselas tienen detalle suficiente para el nivel de calle.
9. ¿Por qué los objetos se cortan en los bordes de las teselas?
Cada tesela vectorial solo contiene las partes de los objetos que caen dentro de ella, más un pequeño margen. Un río largo o un país grande se guarda en muchos trozos, uno por tesela. Los renderizadores dibujan los trozos uno junto a otro y el corte no se ve. En la exportación GeoJSON los trozos quedan separados, cada uno con un atributo _tile.
10. ¿Por qué faltan algunas capas en los metadatos?
La fila de metadatos json la escribe la herramienta que creó el archivo. Si el archivo se editó, se unió desde varias fuentes o se creó con un script, una capa puede estar en las teselas sin aparecer en la lista. El visor decodifica una muestra de teselas, encuentra esas capas igualmente y las marca como «no está en los metadatos».
11. ¿Qué es el esquema TMS en MBTiles?
MBTiles numera las filas de teselas desde abajo (el sur), como el antiguo estándar TMS, mientras que los mapas web las numeran desde arriba (el norte). Cualquier programa que lea MBTiles debe invertir la fila: tile_row = 2^z − 1 − y. Si un mapa de un MBTiles aparece al revés o en el hemisferio equivocado, la causa probable es que falta esa inversión.
12. ¿Cuánto deben pesar las teselas vectoriales?
Mantén cada tesela por debajo de 500 KB, el límite por defecto de tippecanoe y un límite habitual de los servicios de teselas. La mayoría de las buenas teselas pesan entre 10 y 200 KB. La pestaña Teselas muestra las más grandes por nivel de zoom, y el informe sugiere formas de reducirlas.
13. ¿Puedo editar un archivo MBTiles con este visor?
No, solo lee. Para cambiar los datos, edita la fuente (GeoJSON, Shapefile, una base de datos) y vuelve a crear las teselas con tippecanoe, Planetiler o QGIS. Para corregir una fila de metadatos, abre el archivo en DB Browser for SQLite y edita la tabla metadata.
14. ¿Puedo convertir MBTiles a GeoJSON?
Para una parte del mapa, sí: acércate a la zona y pulsa «GeoJSON (vista)». Exporta las capas visibles de las teselas de la vista, hasta 64 teselas a la vez. Para un tileset completo, lo más limpio es exportar desde los datos originales, porque las teselas están simplificadas y cortadas en los bordes.
15. ¿Puedo convertir MBTiles a PMTiles?
Sí, con el convertidor gratuito de MBTiles a PMTiles de este sitio. PMTiles es un único archivo que MapLibre puede leer desde cualquier alojamiento estático, sin servidor de teselas. Las teselas de dentro quedan exactamente iguales.
16. ¿Un archivo MBTiles incluye un estilo de mapa?
No. Un MBTiles vectorial solo contiene datos; los colores, grosores de línea y etiquetas vienen de un estilo, normalmente un JSON de estilo de MapLibre o Mapbox. Este visor elige los colores automáticamente a partir de los nombres de las capas para que veas la estructura al instante.
17. ¿Qué herramientas crean MBTiles vectoriales?
Las más comunes son tippecanoe (a partir de GeoJSON y CSV), Planetiler y OpenMapTiles (a partir de OpenStreetMap), QGIS (Generar teselas XYZ / exportación de teselas vectoriales) y el controlador MVT de GDAL. La pestaña Archivo muestra el generador cuando el archivo lo registra.
18. ¿Qué es tilestats?
tilestats es una parte de los metadatos json que escribe tippecanoe. Cuenta los objetos de cada capa y lista nombres y tipos de atributos y hasta 100 valores de ejemplo. Cuando está presente, el visor muestra el total de objetos de cada capa.
19. ¿Puedo ver MBTiles ráster aquí?
Esta página está hecha para teselas vectoriales. Si abres un archivo ráster, el visor reconoce las teselas de imagen y te enlaza al visor de MBTiles de este sitio, que muestra teselas PNG, JPEG y WebP.
20. ¿Funciona en el móvil o la tableta?
Sí, en cualquier navegador actual de iOS, Android, Windows, macOS y Linux. En el móvil usa archivos pequeños (menos de 100 MB), abre la versión en pantalla completa para tener más espacio y toca un objeto para inspeccionarlo.
Especificaciones, software y créditos de datos
El visor se basa en especificaciones y software abiertos:
- MBTiles Specification (Mapbox) · SpecificationEspecificación MBTiles de Mapbox: la estructura SQLite del archivo, el orden de filas TMS y las filas de metadatos que revisa el visor.
- Mapbox Vector Tile Specification · SpecificationEspecificación Mapbox Vector Tile: la estructura protobuf, los comandos de geometría y las reglas de orientación que sigue el decodificador.
- sql.js · MITSQLite compilado a WebAssembly, que abre la base de datos .mbtiles en tu navegador.
- Leaflet 1.9 · BSD-2-ClauseMapa interactivo y la capa de cuadrícula en canvas que dibuja las teselas.
- Natural Earth · Public domainDatos de dominio público usados para crear el tileset de ejemplo (países, lagos, ríos y ciudades a escala 1:50m).
- Protomaps (hosted by KONAKTIVE), CARTO, OpenStreetMap, Esri World Imagery · ODbL and provider termsMapas base opcionales: teselas vectoriales propias alojadas por KONAKTIVE, con CARTO y OpenStreetMap como respaldo, y Esri World Imagery.
El decodificador de teselas vectoriales, el renderizador, las comprobaciones y todas las exportaciones se escribieron para este sitio y funcionan por completo en tu navegador.
Herramientas relacionadas de teselas y archivos SIG
Las comprobaciones siguen las especificaciones MBTiles 1.3 y Mapbox Vector Tile 2.1 y la práctica habitual; superarlas no garantiza que todas las apps de mapas acepten el archivo. Sample data: Natural Earth. Optional base maps © OpenStreetMap contributors, Protomaps (hosted by KONAKTIVE), CARTO, Esri.
