No description
Find a file
Eric Fischer 6643d4daca
Merge pull request #47 from mapbox/vector-revision
1.3 - Attempt to document the de facto requirements for mbtiles
2018-02-05 17:27:05 -05:00
1.0 Updating 1.0 2011-02-07 17:25:58 -05:00
1.1 Line-breaking 1.1 spec, expanding README 2011-09-08 16:34:33 -04:00
1.2 Deflated -> compressed. Fixes #41 2016-04-01 18:34:58 -04:00
1.3 Call out known spec problems to be addressed in the future 2018-02-05 14:21:01 -08:00
CHANGELOG.md Re-organized README, created a CHANGELOG file, added LICENSE file, added CONTRIBUTING.md process. Updated the wording of several statements in 1.3 of the spec. Clarified the use of RFC 2119. 2018-01-16 09:23:45 -06:00
CONTRIBUTING.md Re-organized README, created a CHANGELOG file, added LICENSE file, added CONTRIBUTING.md process. Updated the wording of several statements in 1.3 of the spec. Clarified the use of RFC 2119. 2018-01-16 09:23:45 -06:00
LICENSE Re-organized README, created a CHANGELOG file, added LICENSE file, added CONTRIBUTING.md process. Updated the wording of several statements in 1.3 of the spec. Clarified the use of RFC 2119. 2018-01-16 09:23:45 -06:00
README.md Reconcile with some of Paul's wording 2018-01-22 11:29:19 -08:00

MBTiles Specification

MBTiles is a specification for storing arbitrary tiled map data in SQLite databases for immediate usage and for efficient transfer. MBTiles files, known as tilesets, must implement the specification below to ensure compatibility with devices.

Versions

Concept

MBTiles is a compact, restrictive specification. It supports only tiled data, including vector or image tiles and interactivity grid tiles. Only the Spherical Mercator projection is supported for presentation (tile display), and only latitude-longitude coordinates are supported for metadata such as bounds and centers.

It is a minimum specification, only specifying the ways in which data must be retrievable. Thus MBTiles files can internally compress and optimize data, and construct views that adhere to the MBTiles specification.

Unlike Spatialite, GeoJSON, and Rasterlite, MBTiles is not raw data storage. It is storage for tiled data, like rendered map tiles.

One MBTiles file represents a single tileset, optionally including grids of interactivity data. Multiple tilesets (layers, or maps in other terms) can be represented by multiple MBTiles files.

UTFGrid

The MBTiles specification previously contained the UTFGrid specification. It was removed in version 1.2 and moved into its own specification with synced version numbers, so MBTiles 1.2 is compatible with UTFGrid 1.2. The specs integrate but do not require each other for compliance.

Implementations.

License

The text of this specification is licensed under a Creative Commons Attribution 3.0 United States License. However, the use of this spec in products and code is entirely free: there are no royalties, restrictions, or requirements.

Authors

  • Eric Fischer (ericfischer)
  • Konstantin Kaefer (kkaefer)
  • Tom MacWright (tmcw)
  • Justin Miller (incanus)
  • Paul Norman (pnorman)
  • Blake Thompson (flippmoke)
  • Will White (willwhite)