Un visualizzatore MBTiles vettoriali che funziona nel browser
Un file MBTiles è un’intera mappa a tile racchiusa in un solo file. Dentro c’è un piccolo database SQLite: una tabella con le tile e una con le informazioni su di esse. Gli MBTiles vettoriali contengono Mapbox Vector Tiles, tile binarie compatte con strade, edifici, fiumi, confini e i loro attributi, pronte per lo stile di un’app di mappe. Si creano con strumenti come tippecanoe, Planetiler, OpenMapTiles e QGIS, e alimentano molte mappe MBTiles offline e ospitate in proprio.
Il problema arriva quando vuoi guardarci dentro. Il computer non sa aprire il file, i visualizzatori di immagini non vedono nulla e quasi tutti i visualizzatori online mostrano solo tile raster. Per vedere un MBTiles vettoriale di solito servono un server di tile, uno stile e un po’ di JavaScript, oppure un programma GIS completo. Questo visualizzatore MBTiles vettoriali online salta tutto questo: trascina il file e lui legge il database, decodifica le tile vettoriali nel browser e disegna ogni layer sulla mappa con il suo colore.
È pensato tanto per controllare quanto per vedere. Puoi cliccare su qualsiasi oggetto per leggerne gli attributi, accendere e spegnere i layer, vedere quanto pesano le tile a ogni livello di zoom e quali sono le più grandi, e controllare il file secondo le specifiche MBTiles e delle tile vettoriali. Alla fine esporta gli oggetti della vista in GeoJSON, salva un PNG della mappa o scarica un rapporto tecnico per un collega o un cliente. Il mio parere: esegui i controlli prima di mettere un tileset su un server. Quasi tutti i problemi di "mappa bianca" sono una riga di metadati mancante o un intervallo di zoom sbagliato, ed è molto più facile correggerli prima della pubblicazione.
Cosa fa il visualizzatore MBTiles vettoriali
Ecco tutto ciò che fa lo strumento, nell’ordine in cui lo incontrerai.
- Apri il file. Trascina un file .mbtiles sulla mappa o clicca su "Apri MBTiles". I file fino a 300 MB si aprono nel browser con il motore SQLite sql.js. "Prova un esempio" carica un piccolo tileset mondiale con paesi, laghi, fiumi e città, così vedi subito lo strumento all’opera.
- Vedi subito la mappa. Lo strumento legge estensione e centro dai metadati e zooma sui dati. Ogni layer viene disegnato su un canvas con il suo colore: poligoni come riempimenti chiari, linee come tratti, punti come cerchi. I nomi di layer comuni come water, landuse, building, transportation e place ricevono colori naturali.
- Lavora con i layer. La scheda Layer elenca ogni layer dei metadati e delle tile con i suoi tipi di geometria, il numero di oggetti in un campione e tutti i campi con un valore di esempio. Accendi e spegni i layer, premi "Solo" per vedere un layer da solo, oppure clicca sul quadratino di colore per scegliere il tuo colore.
- Clicca per ispezionare gli oggetti. Clicca sulla mappa e una scheda mostra ogni oggetto in quel punto nei layer visibili: layer, tipo di geometria, ID e tutti gli attributi. L’oggetto viene evidenziato sulla mappa e puoi copiarlo come GeoJSON o scaricare l’intera tile come file .pbf grezzo.
- Leggi le informazioni del file. La scheda File mostra i metadati in parole semplici: nome, descrizione, attribuzione, versione, formato, compressione, intervallo di zoom, estensione, centro, lo strumento che lo ha generato (per esempio tippecanoe) e la dimensione del file e dei dati delle tile.
- Controlla le tile. La scheda Tile indica il numero di tile, la dimensione totale, media e massima per livello di zoom e le dieci tile più grandi del file. Clicca su "Vedi" per andare a una tile. L’opzione griglia disegna ogni bordo di tile con il suo z/x/y e la dimensione.
- Esegui i controlli. La scheda Controlli verifica il file: tabella tiles, metadati, formato, compressione, l’elenco vector_layers in json, layer mancanti dai metadati, estensione, centro, intervallo di zoom rispetto alle tile reali, tile oltre 500 KB e attribuzione. Ogni controllo è segnato come OK, avviso o errore, con una spiegazione semplice.
- Ingrandisci oltre i dati. Le tile vettoriali restano nitide anche oltre l’ultimo livello di zoom, quindi il visualizzatore continua a disegnare ingrandite le tile più profonde ("overzoom"). Sotto il primo livello, un avviso ti chiede di ingrandire.
- Regola la visualizzazione. Cambia opacità del riempimento e spessore delle linee, attiva o disattiva le etichette dei luoghi e aggiungi una mappa stradale o satellitare per orientarti. Senza mappa di base non viene caricato nulla da altri server.
- Esporta. Scarica gli oggetti visibili in GeoJSON, la vista della mappa in PNG, i metadati in JSON o un rapporto tecnico con controlli, layer, campi, statistiche delle tile e raccomandazioni.
Il file viene letto con JavaScript e WebAssembly dentro la scheda del browser. Non viene mai caricato, quindi il visualizzatore è sicuro anche per dati privati o soggetti a licenza.
Come vedere un file MBTiles vettoriale, passo per passo
Un esempio reale con il tileset mondiale di esempio (dati Natural Earth, zoom da 0 a 5).
Lo strumento si apre con una mappa vuota e un’area di rilascio. Trascinaci il tuo file .mbtiles, clicca per scegliere un file oppure premi "Prova un esempio".
Il visualizzatore legge il database SQLite, zooma sull’estensione e disegna tutti e quattro i layer: paesi come riempimenti grigi, laghi in blu, fiumi come linee blu e città come punti rossi con etichette.
La scheda Layer elenca ogni layer con la sua geometria, gli oggetti trovati in un campione e ogni campo con un valore di esempio. Qui sono accesi solo fiumi e città, con la vista sull’Europa.
Clicca su una città. La scheda mostra layer, tipo di geometria, ID e tutti gli attributi, e l’oggetto viene evidenziato. Puoi copiarlo come GeoJSON o scaricare la tile da cui proviene.
La scheda File trasforma la tabella metadata in informazioni chiare: nome, attribuzione, formato, compressione gzip, zoom da 0 a 5, estensione, centro e dimensione del file.
La scheda Tile mostra tile e dimensioni per livello di zoom e le tile più grandi. Con la griglia attiva, ogni bordo di tile è disegnato con il suo z/x/y e la dimensione salvata.
La scheda Controlli verifica il file secondo le regole MBTiles e delle tile vettoriali. L’esempio supera tutti i controlli; un file reale mostra spesso uno o due avvisi, ognuno con la sua spiegazione.
Il rapporto tecnico raccoglie in una pagina il riepilogo, un’anteprima della mappa, i controlli, i metadati, ogni layer e campo, le statistiche delle tile e le raccomandazioni. Stampalo o salvalo in PDF.
Come aprire un file MBTiles: le tue opzioni
Ci sono diversi modi per aprire un file MBTiles. Quello giusto dipende da cosa vuoi fare: solo guardarlo, controllarlo o usarlo in un progetto.
- Nel browser, con questo visualizzatore. Il modo più veloce per vedere cosa c’è in un file vettoriale: niente da installare, nessun server, su Windows, Mac, Linux e tablet. Ideale per controllare un tileset, leggere gli attributi e condividere un rapporto. Per gli MBTiles raster (tile PNG, JPEG, WebP) usa il visualizzatore MBTiles di questo sito.
- In QGIS. QGIS 3.14 e successivi aprono direttamente gli MBTiles vettoriali: trascina il file sulla mappa oppure usa Layer → Aggiungi layer → Aggiungi layer di tile vettoriali. Gli MBTiles raster si aprono con Layer → Aggiungi layer → Aggiungi layer raster. Comodo per combinare le tile con altri dati GIS.
- Con un server di tile. TileServer GL, Martin e mbtileserver leggono un file MBTiles e servono le sue tile via HTTP, così una mappa web in MapLibre GL JS, Mapbox GL JS o Leaflet può usarle. È così che di solito si pubblicano le mappe MBTiles.
- Come PMTiles. Converti il file in PMTiles (su questo sito c’è un convertitore gratuito) e metti quell’unico file su qualsiasi hosting statico o storage a oggetti. MapLibre lo legge direttamente, senza server di tile.
- Su telefono o GPS. Molte app di mappe offline caricano file MBTiles per usarli senza connessione. Verifica quale formato di tile si aspetta l’app: alcune accettano solo tile raster.
- Come database. Poiché MBTiles è SQLite, lo aprono anche DB Browser for SQLite o la riga di comando sqlite3. Vedi tabelle e blob binari, non la mappa, ma è utile per correggere una riga di metadati.
Una cosa è uguale ovunque: un file MBTiles contiene dati, non uno stile. Ogni app decide come colorare i layer. Questo visualizzatore sceglie i colori in automatico, così vedi la struttura senza scrivere prima uno stile.
Come il visualizzatore legge e disegna le tile vettoriali
Aprire un MBTiles vettoriale richiede quattro passaggi: leggere il database SQLite, trovare la tile giusta, decomprimerla e decodificarla, e disegnarla. Ecco esattamente cosa succede, con le formule.
1. Il database MBTiles
Un file MBTiles è un database SQLite con due tabelle obbligatorie. Il visualizzatore lo carica in memoria con sql.js, una versione di SQLite compilata in WebAssembly, ed esegue normali query SQL:
CREATE TABLE metadata (name text, value text);
CREATE TABLE tiles (zoom_level integer, tile_column integer,
tile_row integer, tile_data blob);
righe di metadata: name, format = pbf, minzoom, maxzoom, bounds,
center, attribution, description, json, …
statistiche: SELECT zoom_level, COUNT(*), SUM(LENGTH(tile_data)),
MAX(LENGTH(tile_data)) FROM tiles GROUP BY zoom_levelAlcuni file salvano tiles come vista su due tabelle (map e images), così le tile identiche come l’oceano vuoto vengono salvate una sola volta. Il visualizzatore gestisce entrambe le strutture e ti dice quale usa il tuo file.
2. Dalla posizione sulla mappa alla riga della tile: l’inversione TMS
Una mappa web numera le tile dall’alto (la riga 0 è a nord). MBTiles segue il vecchio schema TMS e numera le righe dal basso. Per questo ogni richiesta di tile inverte la riga:
n = 2^z tile per lato allo zoom z x = ⌊(λ + 180) / 360 × n⌋ y = ⌊(1 − ln(tan φ + sec φ) / π) / 2 × n⌋ riga della mappa web (da nord) tile_row = n − 1 − y riga MBTiles (da sud) esempio z = 5, x = 16, y = 10 → tile_row = 32 − 1 − 10 = 21
Dimenticare questa inversione è l’errore più comune nei lettori MBTiles fatti in casa: la mappa mostra allora l’emisfero sud al posto del nord. Se la tua app disegna i dati capovolti o nel posto sbagliato, controlla prima questo.
3. Decomprimere la tile
Le tile vettoriali sono quasi sempre compresse. Il visualizzatore legge i primi byte della tile per capire come, poi la decomprime con il DecompressionStream integrato nel browser:
1F 8B … gzip (la maggior parte: tippecanoe, Planetiler, OpenMapTiles) 78 01/5E/9C/DA zlib (alcuni strumenti più vecchi) altro non compressa 89 50 4E 47 PNG ┐ FF D8 JPEG ├ tile raster: non è un file vettoriale 52 49 46 46 WebP ┘
Lo stesso controllo riconosce gli MBTiles raster anche quando i loro metadati sono sbagliati, e ti indirizza al visualizzatore raster invece di mostrare una mappa vuota.
4. Decodificare il protobuf
Una Mapbox Vector Tile è un messaggio Protocol Buffers. I numeri sono salvati come varint: 7 bit per byte, e l’8° bit indica "seguono altri byte". I valori con segno usano la codifica zigzag, così i piccoli numeri negativi restano corti:
varint 300 = 1010 1100 0000 0010 → 0101100 + 0000010 × 128 = 300
zigzag 0 → 0, −1 → 1, 1 → 2, −2 → 3, 2 → 4
decodifica: 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 [indice chiave, indice valore, indice chiave, indice valore, …]Nomi e valori degli attributi sono salvati una sola volta per layer, negli elenchi keys e values. Ogni oggetto conserva solo coppie di indici, per questo le tile vettoriali sono così compatte. Il decodificatore del visualizzatore è scritto a partire dalla specifica ed è stato testato contro il decodificatore di riferimento di Mapbox su oltre 350.000 oggetti, senza nessuna differenza.
5. Comandi di geometria
La geometria è un elenco di comandi. Ogni intero di comando contiene un id di comando e un conteggio; i parametri che seguono sono in zigzag e relativi al punto precedente. Le coordinate sono in unità di tile, da 0 a 4096 da un bordo all’altro per impostazione predefinita (l’"extent"):
comando = (conteggio << 3) | id MoveTo = 1, LineTo = 2, ClosePath = 7
9 = (1 << 3) | 1 MoveTo, 1 punto
parametri 50, 34 → +25, +17 cursore (25, 17)
18 = (2 << 3) | 2 LineTo, 2 punti
parametri 0, 18, 18, 0 → (25, 26), (34, 26)
15 = (1 << 3) | 7 ClosePath
anelli dei poligoni: area > 0 anello esterno (orario sullo schermo)
area < 0 foro
area = ½ Σ (x_j·y_i − x_i·y_j) formula di Gauss, y verso il bassoIl segno dell’area dell’anello distingue gli anelli esterni dai fori, quindi un lago dentro un paese resta un foro sia nel disegno sia nell’export in GeoJSON.
6. Disegno, scala e overzoom
Ogni tile della mappa è un canvas di 256 × 256 pixel (512 sugli schermi ad alta risoluzione). Le unità di tile vengono scalate in pixel, e oltre l’ultimo livello di zoom la tile superiore viene ingrandita e spostata, cosa che si chiama overzoom:
scala = 256 × f / extent f = 2^(z_mappa − z_dati) spostamento = (x mod f, y mod f) × 256 parte della tile superiore da mostrare esempio dati fino a z 14, mappa a z 16 f = 4, scala = 256 × 4 / 4096 = 0.25 px per unità la tile (x, y) della mappa usa la tile dati (⌊x/4⌋, ⌊y/4⌋)
Poiché i dati sono vettoriali, le linee vengono ridisegnate alla nuova scala e restano nitide, a differenza delle tile raster ingrandite. Spessori delle linee e dimensioni dei punti sono divisi per la scala, così sullo schermo restano uguali a ogni livello di zoom.
7. Cliccare su un oggetto: il test di selezione
Quando clicchi, il visualizzatore trova la tile dati sotto il cursore, converte il clic in unità di tile e testa gli oggetti dei layer visibili dal layer più in alto verso il basso:
unità per pixel = extent / (256 × 2^(z_mappa − z_dati))
punto selezionato se la distanza ≤ 7 px
linea selezionata se la distanza da un segmento ≤ 5 px
d² = |p − a − t(b − a)|², t = clamp(((p − a)·(b − a)) / |b − a|², 0, 1)
poligono selezionato se un raggio dal punto incrocia gli anelli un numero dispari di volteUn rapido test sul rettangolo di ingombro scarta quasi tutti gli oggetti prima del test esatto, così anche le tile con decine di migliaia di oggetti rispondono subito.
8. Budget di dimensione per tile
Le tile grandi rallentano le mappe: ognuna va scaricata, decompressa e decodificata prima che appaia qualcosa. tippecanoe limita le tile a 500 KB per impostazione predefinita, e lo stesso limite di 500 KB è molto diffuso nei servizi di tile vettoriali. Il visualizzatore misura ogni tile con una sola query SQL e segnala i livelli di zoom che lo superano:
dimensione salvata = LENGTH(tile_data) byte, ancora compressi dimensione media = SUM(dimensione) / COUNT(*) per livello di zoom copertura = tile / 4^z quota della griglia mondiale riferimento tile più grande < 500 KB (512.000 byte)
In pratica le tile più grandi si trovano di solito a uno zoom intermedio sulle città dense, dove molti edifici e strade si incontrano prima che la semplificazione li sfoltisca. L’elenco delle tile più grandi ti porta direttamente lì.
MBTiles e i formati di esportazione nel dettaglio
Cosa c’è dentro un file MBTiles, in cosa si differenziano gli MBTiles vettoriali e raster, e cosa contiene ogni download di questo visualizzatore.
MBTiles vettoriale .mbtiles
Un database SQLite che segue la specifica MBTiles 1.3, con format = pbf. Ogni tile è una Mapbox Vector Tile compressa con gzip, con uno o più layer con nome. La riga di metadati json elenca i layer e i loro campi, e tippecanoe aggiunge anche tilestats con il numero di oggetti e valori degli attributi.
metadata.json = {
"vector_layers": [
{ "id": "cities", "minzoom": 0, "maxzoom": 5,
"fields": { "name": "String", "pop_max": "Number" } } ],
"tilestats": { "layerCount": 1, "layers": [ … ] }
}Gli MBTiles vettoriali sono leggeri per l’area che coprono, si possono stilizzare liberamente e restano nitidi a ogni zoom. Servono un motore di rendering (MapLibre, Mapbox GL, QGIS o questo visualizzatore) e uno stile per sembrare una mappa finita.
MBTiles raster .mbtiles
La stessa struttura di database, ma ogni tile è un’immagine finita (PNG, JPEG o WebP), di solito 256 × 256 pixel. Lo stile è fissato nei pixel, quindi la mappa appare uguale ovunque, ma non si può cambiare stile né interrogarla, e diventa sfocata oltre il suo ultimo livello di zoom.
Questo visualizzatore riconosce i file raster dalla firma delle loro immagini e ti indirizza al visualizzatore MBTiles raster di questo sito, pensato per loro.
GeoJSON (vista) .geojson
Tutti gli oggetti dei layer visibili nelle tile che coprono la vista attuale, al livello di zoom dei dati attuale, come FeatureCollection RFC 7946 in WGS84. Ogni oggetto mantiene i suoi attributi e ne riceve due in più: _layer e _tile. I poligoni sono raggruppati in Polygon o MultiPolygon con i loro fori.
{ "type": "Feature", "id": 812,
"properties": { "name": "Lyon", "pop_max": 1423000,
"_layer": "cities", "_tile": "5/16/11" },
"geometry": { "type": "Point", "coordinates": [4.8320114, 45.7578137] } }Gli oggetti sono tagliati ai bordi delle tile, come sono salvati, quindi una strada lunga può uscire in più pezzi. Un’esportazione copre al massimo 64 tile; ingrandisci per esportare un’area più piccola con più dettaglio.
PNG (vista) .png
Un’immagine dei layer vettoriali come li vedi nella finestra della mappa, con sfondo bianco, una barra del titolo con nome del file e livello di zoom, e l’attribuzione dei metadati.
Comodo per documentazione, una segnalazione di bug o un’anteprima veloce per un cliente. La mappa di base non è inclusa, quindi non ci sono diritti di immagine di terzi da gestire.
Metadati (JSON) .json
Tutte le righe della tabella metadata, con la riga json convertita in vero JSON, più le statistiche delle tile per livello di zoom e l’elenco dei layer trovati nelle tile.
Utile per confrontare due versioni di un tileset o copiare l’elenco vector_layers in uno stile MapLibre.
Tile (.pbf) .pbf
La tile vettoriale sotto il tuo clic, decompressa, esattamente come la invierebbe un server di tile dopo la decompressione. Il nome del file contiene il suo z/x/y.
Passala ad altri strumenti (per esempio vt2geojson o un visualizzatore protobuf) per analizzare una tile nel dettaglio.
Rapporto tecnico .html
Una pagina HTML con il riepilogo del file, un’anteprima della mappa, tutti i controlli, la tabella metadata completa, i layer con i tipi di geometria e i campi, le tile per livello di zoom, le tile più grandi, raccomandazioni e come usare il file.
Si stampa bene in PDF. Allegalo a un ticket o mandalo con una consegna, così chi lo riceve vede cosa c’è nel tileset senza aprirlo.
Tutte le esportazioni sono create nel tuo browser dal file aperto. Niente viene inviato a un server.
Chi usa un visualizzatore MBTiles vettoriali
Le tile vettoriali stanno tra i dati e la mappa, quindi persone molto diverse hanno bisogno di guardarci dentro.
- Sviluppatori di mappe web. Controlla un tileset prima di scrivere uno stile MapLibre o Mapbox GL: quali layer esistono, come si chiamano i campi, a quali livelli di zoom compaiono i dati. L’elenco dei campi e i valori di esempio evitano molti tentativi.
- Analisti GIS. Verifica che un’esportazione di tippecanoe, Planetiler o QGIS contenga ciò che ti aspetti, con gli attributi e l’intervallo di zoom giusti, prima di consegnarla.
- DevOps e amministratori di server di tile. Trova tile troppo grandi, metadati mancanti e intervalli di zoom sbagliati prima del rilascio su TileServer GL, Martin o una CDN, e conserva il rapporto come documentazione.
- Cartografia offline e sul campo. Controlla che le mappe MBTiles caricate su tablet o dispositivi da campo coprano l’area e i livelli di zoom giusti prima di restare senza rete.
- Acquirenti e revisori di dati. Guarda un tileset vettoriale di un fornitore senza installare nulla, scorri gli attributi e rimanda il rapporto.
- Studenti e insegnanti. Scopri come funzionano davvero le tile vettoriali: attiva la griglia, confronta le dimensioni delle tile tra i livelli di zoom e osserva l’overzoom mantenere nitide le linee.
- Editori di dati aperti. Verifica attribuzione, estensione e descrizione nei metadati prima di pubblicare un tileset, così gli utenti ricevono il credito corretto e una vista iniziale giusta.
- Supporto e segnalazioni di bug. Quando una mappa mostra un buco o un oggetto rotto, trova la tile, scaricala come .pbf e allegala al ticket insieme al rapporto.
Domande frequenti su MBTiles e tile vettoriali
Le 20 domande più comuni sui file MBTiles e su questo visualizzatore.
1. Che cos’è un file MBTiles?
Un file MBTiles è un database SQLite che salva tile di mappa. Ha una tabella tiles con una riga per tile (zoom, colonna, riga e dati della tile) e una tabella metadata con nome, formato, intervallo di zoom, estensione e altre informazioni. Un solo file può contenere un’intera mappa a tile, per questo è facile copiarlo, condividerlo e usarlo offline.
2. Che differenza c’è tra MBTiles vettoriali e raster?
Gli MBTiles raster salvano immagini finite (PNG, JPEG o WebP). Quelli vettoriali salvano Mapbox Vector Tiles: geometria e attributi che l’app di mappe stilizza e disegna da sola. I file vettoriali sono più leggeri per la stessa area, restano nitidi a ogni zoom e si possono restilizzare o interrogare. Guarda la riga format: pbf significa vettoriale.
3. Come apro un file MBTiles?
Per dare un’occhiata veloce a un file vettoriale, trascinalo in questo visualizzatore: niente da installare, niente da caricare. In QGIS 3.14 o successivo, trascina il file sulla mappa oppure usa Layer → Aggiungi layer → Aggiungi layer di tile vettoriali. Per pubblicarlo su un sito, servilo con TileServer GL, Martin o mbtileserver, oppure convertilo in PMTiles. La sezione "Come aprire un file MBTiles" qui sopra confronta tutte le opzioni.
4. Questo visualizzatore MBTiles vettoriali è gratuito?
Sì. È gratuito, senza account, senza limite giornaliero di file e senza filigrana sulle esportazioni. Tutto funziona nel tuo browser, quindi non ci sono costi di server.
5. Il mio file viene caricato da qualche parte?
No. Il file viene letto con FileReader e aperto con sql.js (SQLite in WebAssembly) dentro la scheda del browser. Anche la decodifica e il disegno delle tile avvengono lì. Solo se attivi una mappa di base il browser carica tile stradali o satellitari da quei fornitori; il tuo file resta in locale.
6. Quanto può essere grande il file?
Fino a 300 MB. L’intero database viene caricato nella memoria del browser, quindi i file molto grandi richiedono molta RAM. Su telefoni e tablet funzionano meglio i file sotto i 100 MB. Per tileset su scala planetaria usa un server di tile o QGIS.
7. Perché la mappa è vuota quando il file si apre?
Di solito la mappa è sotto il primo livello di zoom del file: un tileset cittadino può iniziare allo zoom 10, e il visualizzatore mostra allora un avviso per ingrandire. Altre cause sono bounds sbagliati nei metadati (la mappa va nel posto sbagliato) o tile raster nel file. La scheda Controlli ti dice qual è.
8. Cosa significa overzoom?
Un tileset ha un ultimo livello di zoom, spesso 14. Se ingrandisci oltre, il visualizzatore continua a usare le tile dello zoom 14 e le disegna più grandi. Poiché i dati vettoriali vengono ridisegnati, le linee restano nitide. Per questo molte mappe di base si fermano allo zoom 14: le tile hanno abbastanza dettaglio per il livello stradale.
9. Perché gli oggetti sono tagliati ai bordi delle tile?
Ogni tile vettoriale contiene solo le parti degli oggetti che cadono al suo interno, più un piccolo margine. Un fiume lungo o un paese grande è salvato in tanti pezzi, uno per tile. I motori di rendering disegnano i pezzi uno accanto all’altro e il taglio non si vede. Nell’esportazione GeoJSON i pezzi restano separati, ognuno con un attributo _tile.
10. Perché alcuni layer mancano dai metadati?
La riga di metadati json viene scritta dallo strumento che ha creato il file. Se il file è stato modificato, unito da più fonti o creato con uno script, un layer può essere nelle tile senza comparire nell’elenco. Il visualizzatore decodifica un campione di tile, trova comunque questi layer e li segna come "non nei metadati".
11. Cos’è lo schema TMS negli MBTiles?
MBTiles numera le righe delle tile dal basso (sud), come il vecchio standard TMS, mentre le mappe web le numerano dall’alto (nord). Ogni programma che legge MBTiles deve invertire la riga: tile_row = 2^z − 1 − y. Se una mappa da un MBTiles appare capovolta o nell’emisfero sbagliato, la causa probabile è l’inversione mancante.
12. Quanto devono essere grandi le tile vettoriali?
Tieni ogni tile sotto i 500 KB, il limite predefinito di tippecanoe e un limite comune dei servizi di tile. Le tile ben fatte stanno di solito tra 10 e 200 KB. La scheda Tile mostra le più grandi per livello di zoom, e il rapporto suggerisce come ridurle.
13. Posso modificare un file MBTiles con questo visualizzatore?
No, legge soltanto. Per cambiare i dati, modifica la fonte (GeoJSON, Shapefile, un database) e rigenera le tile con tippecanoe, Planetiler o QGIS. Per correggere una riga di metadati, apri il file in DB Browser for SQLite e modifica la tabella metadata.
14. Posso convertire un MBTiles in GeoJSON?
Per una parte della mappa sì: ingrandisci sull’area e premi "GeoJSON (vista)". Vengono esportati i layer visibili delle tile della vista, fino a 64 tile alla volta. Per un tileset intero è più pulito esportare dai dati di origine, perché le tile sono semplificate e tagliate ai bordi.
15. Posso convertire un MBTiles in PMTiles?
Sì, con il convertitore gratuito da MBTiles a PMTiles di questo sito. PMTiles è un unico file che MapLibre può leggere da qualsiasi hosting statico, senza server di tile. Le tile all’interno restano esattamente uguali.
16. Un file MBTiles contiene uno stile di mappa?
No. Un MBTiles vettoriale contiene solo dati; colori, spessori e etichette vengono da uno stile, di solito un JSON di stile MapLibre o Mapbox. Questo visualizzatore sceglie i colori in automatico dai nomi dei layer, così vedi subito la struttura.
17. Quali strumenti creano MBTiles vettoriali?
I più comuni sono tippecanoe (da GeoJSON e CSV), Planetiler e OpenMapTiles (da OpenStreetMap), QGIS (Genera tile XYZ / esportazione di tile vettoriali) e il driver MVT di GDAL. La scheda File mostra lo strumento generatore quando il file lo registra.
18. Cos’è tilestats?
tilestats è una parte dei metadati json scritta da tippecanoe. Conta gli oggetti di ogni layer ed elenca nomi e tipi degli attributi e fino a 100 valori di esempio. Quando è presente, il visualizzatore mostra il numero totale di oggetti di ogni layer.
19. Posso vedere MBTiles raster qui?
Questa pagina è fatta per le tile vettoriali. Se apri un file raster, il visualizzatore riconosce le tile immagine e ti rimanda al visualizzatore MBTiles di questo sito, che mostra tile PNG, JPEG e WebP.
20. Funziona su telefono o tablet?
Sì, in qualsiasi browser recente su iOS, Android, Windows, macOS e Linux. Sul telefono usa file piccoli (sotto i 100 MB), apri la versione a schermo intero per avere più spazio e tocca un oggetto per ispezionarlo.
Specifiche, software e crediti dei dati
Il visualizzatore si basa su specifiche e software aperti:
- MBTiles Specification (Mapbox) · SpecificationSpecifica MBTiles di Mapbox: la struttura SQLite del file, l’ordine delle righe TMS e le righe di metadati controllate dal visualizzatore.
- Mapbox Vector Tile Specification · SpecificationSpecifica Mapbox Vector Tile: la struttura protobuf, i comandi di geometria e le regole di orientamento seguite dal decodificatore.
- sql.js · MITSQLite compilato in WebAssembly, usato per aprire il database .mbtiles nel browser.
- Leaflet 1.9 · BSD-2-ClauseMappa interattiva e il layer a griglia su canvas che disegna le tile.
- Natural Earth · Public domainDati di pubblico dominio usati per creare il tileset di esempio (paesi, laghi, fiumi e città in scala 1:50m).
- Protomaps (hosted by KONAKTIVE), CARTO, OpenStreetMap, Esri World Imagery · ODbL and provider termsMappe di base facoltative: tile vettoriali proprie ospitate da KONAKTIVE, con CARTO e OpenStreetMap come riserva, ed Esri World Imagery.
Il decodificatore di tile vettoriali, il motore di rendering, i controlli e tutte le esportazioni sono stati scritti per questo sito e funzionano interamente nel tuo browser.
Strumenti correlati per tile e file GIS
I controlli seguono le specifiche MBTiles 1.3 e Mapbox Vector Tile 2.1 e la pratica comune; superarli non garantisce che ogni app di mappe accetti il file. Sample data: Natural Earth. Optional base maps © OpenStreetMap contributors, Protomaps (hosted by KONAKTIVE), CARTO, Esri.
