Skip to content
Novus Examples
mbtiles16 KB

MBTiles — Structurally Valid Tileset With No Tiles

Every required MBTiles table and metadata key, and not one tile row. This is what a failed or interrupted tile build actually produces, and it is the fixture that finds code which reports success because the file opened and the schema validated.

Preview — schema + first 8 rowsmbtiles
namevalue
nameEmpty tileset
formatpng
typeoverlay
version1.0.0
descriptionStructurally valid MBTiles containing no tiles
bounds-180.0,-85.0511,180.0,85.0511
minzoom0
maxzoom0
The tiles table exists and is indexed, but contains zero rows.

Specifications

Format
MBTiles 1.3 (SQLite)
Tiles
0
Metadata Rows
8
Min Zoom
0
Max Zoom
0
Schema Complete
true
Bounds
-180.0,-85.0511,180.0,85.0511

Testing contract

Expected to pass
Scenario
Point a tile server or validator at the file and ask it to serve zoom 0.
Expected result
The tileset opens and validates structurally, but the tile query returns no rows and the consumer reports an empty tileset rather than a working layer.

What is a .mbtiles file?

MBTiles is a specification for storing map tiles in a SQLite database. A metadata table records the tile set's name, format, bounds, and zoom range, and a tiles table holds one row per tile keyed by zoom_level, tile_column, and tile_row with the tile image or vector payload as a blob. Crucially, tile_row uses the TMS convention, which is flipped vertically relative to the XYZ scheme most web maps use.

How to use this file

Use an example .mbtiles file to test tile servers, offline map readers, and tile-set converters, verifying the TMS-versus-XYZ row flip, that the metadata bounds agree with the tiles actually present, and that a request outside the zoom range fails cleanly.

How to use this file for testing

“MBTiles — Structurally Valid Tileset With No Tiles” is a deterministic Novus Examples fixture for Geospatial, Error handling, Data import. GeoJSON, GPX, and KML files with points, lines, polygons, and tracks — for testing map tools, route parsers, and geo importers.

Documented properties for this file: MBTiles 1.3 (SQLite). Compare results against paired or grouped companions on this page when present (clean↔damaged, searchable↔scanned, or format twins) so scores stay reproducible across runs.

Download the file once, keep the path stable in CI or local scripts, and treat the spec table as the contract: dimensions, seeds, field lists, and roles are intentional. Corrupt or invalid samples are labelled as such — expect parsers to fail loudly rather than silently accept them.

Geospatial fixtures publish one invented territory across formats, with the coordinate reference system and feature counts documented in specs. Convert or reproject and diff against the twin in the same group; edge-case geometries state exactly which assumption they are built to break.

Generated by generation/geospatial.py. Free for any use, no attribution required — license.