23.03.2026, 17:48
Das Format von openseamaps-mbtiles/2017/ostsee.mbtiles scheint unvollständig zu sein.
Die Tabelle metadata ist leer in der Datei, die routeconverter herunterlädt.
Wenn man diese Tabelle manuell füllt. Erhält man ein funktionstüchtiges Overlay.
Eventuell diese Datei nicht mehr zum Download anbieten oder durch eine neuere ersetzen.
Viele Grüße,
Ilmari
##############################################################################################
Ich habe versucht die openseamaps-mbtiles Ostsee herunterzuladen. Am Ende des Downloads kommt eine Fehlermeldung.
Der Eintrag ist aber dennoch vorhanden und wenn man versucht diese auszuwählen erhalte ich diese Fehlermeldung + Copilot Erklärungsversuch
Cannot display map 'openseamaps-mbtiles/2017/ostsee.mbtiles':
java.lang.IllegalArgumentException: 'metadata.format' field was not found. ...
die ostsee.mbtiles Datenbank enthält eine metadata Tabelle die ist aber leer.
Here’s what that error message means, broken down clearly and specific to RouteConverter and MBTiles.
What the message says (verbatim)
Plain‑English explanation
RouteConverter did open the
file, but then discovered that:
➡️ The file does NOT contain a required MBTiles metadata entry called
.
Because of that, RouteConverter refuses to treat it as a valid MBTiles map and cannot render it.
In short:
Why this happens (important)
MBTiles is not just “tiles in a SQLite file”.
It must contain a table called
with specific keys.
RouteConverter (via Mapsforge/MBTiles reader) expects at least:
is missing, Java throws exactly this exception:
[forum.rout...verter.com]
Very common causes
1️⃣ File is not actually MBTiles
Some files:
2️⃣ File was generated incorrectly
Some tile exporters (especially older OpenSeaMap / OSM tools) omit
, even though other apps tolerate it.
RouteConverter does not. [forum.rout...verter.com]
3️⃣ File is corrupted or incomplete
If the
file was:
How to verify (quick check)
If you open the file with any SQLite viewer and run:
SELECT * FROM metadata;
You should see a row like:
If
is missing → this exact error is expected.
What will NOT fix it
Practical solutions
✅ Best solution
Re‑create the MBTiles file using a tool that writes standards‑compliant MBTiles, e.g.:
✅ Quick workaround (advanced)
If the file does contain tiles, you can manually add the missing metadata:
INSERT INTO metadata (name, value) VALUES ('format', 'png');
``
(or
, depending on the tiles)
⚠️ Only do this if you know the tile image format.
✅ RouteConverter‑native alternative
RouteConverter works best with:
Summary (one‑liner)
Die Tabelle metadata ist leer in der Datei, die routeconverter herunterlädt.
Wenn man diese Tabelle manuell füllt. Erhält man ein funktionstüchtiges Overlay.
Eventuell diese Datei nicht mehr zum Download anbieten oder durch eine neuere ersetzen.
Viele Grüße,
Ilmari
##############################################################################################
Ich habe versucht die openseamaps-mbtiles Ostsee herunterzuladen. Am Ende des Downloads kommt eine Fehlermeldung.
Der Eintrag ist aber dennoch vorhanden und wenn man versucht diese auszuwählen erhalte ich diese Fehlermeldung + Copilot Erklärungsversuch
Cannot display map 'openseamaps-mbtiles/2017/ostsee.mbtiles':
java.lang.IllegalArgumentException: 'metadata.format' field was not found. ...
die ostsee.mbtiles Datenbank enthält eine metadata Tabelle die ist aber leer.
Here’s what that error message means, broken down clearly and specific to RouteConverter and MBTiles.
What the message says (verbatim)
Quote:Cannot display map
:Code:openseamaps-mbtiles/2017/ostsee.mbtiles
java.lang.IllegalArgumentException:
field was not found. Is this an MBTiles database?Code:metadata.format
Plain‑English explanation
RouteConverter did open the
Code:
.mbtiles➡️ The file does NOT contain a required MBTiles metadata entry called
Code:
formatBecause of that, RouteConverter refuses to treat it as a valid MBTiles map and cannot render it.
In short:
Quote:The file is either not a valid MBTiles file, or it is an incomplete / non‑standard MBTiles database.
Why this happens (important)
MBTiles is not just “tiles in a SQLite file”.
It must contain a table called
Code:
metadataRouteConverter (via Mapsforge/MBTiles reader) expects at least:
- Code:
metadata.name - Code:
metadata.type - ✅
← this one is missingCode:metadata.format
- ,Code:
metadata.minzoom
, etc.Code:maxzoom
Code:
metadata.formatCode:
IllegalArgumentException: 'metadata.format' field was not foundVery common causes
1️⃣ File is not actually MBTiles
Some files:
- Are SQLite databases, but not MBTiles
- Or are custom MBTiles variants created by older or niche tools
2️⃣ File was generated incorrectly
Some tile exporters (especially older OpenSeaMap / OSM tools) omit
Code:
metadata.formatRouteConverter does not. [forum.rout...verter.com]
3️⃣ File is corrupted or incomplete
If the
Code:
.mbtiles- Interrupted during creation
- Partially copied
- Truncated
How to verify (quick check)
If you open the file with any SQLite viewer and run:
SELECT * FROM metadata;
You should see a row like:
Code:
name | format | pngCode:
formatWhat will NOT fix it
- Updating Java
- Restarting RouteConverter
- Internet connection
- OpenStreetMap tile policy (this error is offline, not network‑related)
Practical solutions
✅ Best solution
Re‑create the MBTiles file using a tool that writes standards‑compliant MBTiles, e.g.:
- Code:
mb-util - Code:
tilemaker - Code:
MapTiler - → MBTiles outputCode:
osmosis
✅ Quick workaround (advanced)
If the file does contain tiles, you can manually add the missing metadata:
INSERT INTO metadata (name, value) VALUES ('format', 'png');
``
(or
Code:
jpg⚠️ Only do this if you know the tile image format.
✅ RouteConverter‑native alternative
RouteConverter works best with:
- Mapsforge
filesCode:.map
- Its built‑in online map sources
Summary (one‑liner)
Quote:RouteConverter cannot display your map because theIf you want, you can tell me:
file is missing the mandatoryCode:.mbtiles
entry, so it does not qualify as a valid MBTiles database.Code:metadata.format
- Where you got
from, orCode:ostsee.mbtiles
- Which tool created it
Grüße,
Ilmari
