Crate mbtiles

mbtiles

A library to help tile servers like Martin work with MBTiles files. When using as a lib, you may want to disable default features (i.e. the unused “cli” feature).

This crate also has a small utility that allows users to interact with the *.mbtiles files from the command line. See tools documentation for more information.

Development

Any changes to SQL commands require running of just prepare-sqlite. This will install cargo sqlx command if it is not already installed, and update the ./sqlx-data.json file.

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Re-exports

• pub use sqlx;

Structs

• Mbtiles
• MbtilesCopier
• MbtilesPool
• Metadata

Enums

• AggHashType
• CopyDuplicateMode
• CopyType
• IntegrityCheckType
• MbtError
• MbtType
• MbtTypeCli
• PatchType
• PatchTypeCli
• UpdateZoomType

Constants

• AGG_TILES_HASH
  Metadata key for the aggregate tiles hash value
• AGG_TILES_HASH_AFTER_APPLY
  Metadata key for a diff file, describing the eventual AGG_TILES_HASH value of the resulting tileset once the diff is applied
• AGG_TILES_HASH_BEFORE_APPLY
  Metadata key for a diff file, describing the expected AGG_TILES_HASH value of the tileset to which the diff will be applied.

Functions

• action_with_rusqlite
• apply_patch
• calc_agg_tiles_hash
  Compute the hash of the combined tiles in the mbtiles file tiles table/view. This should work on all mbtiles files perf MBTiles specification.
• compute_min_max_zoom
  Compute min and max zoom levels from the tiles table
• create_bsdiffraw_tables
• create_flat_tables
• create_flat_with_hash_tables
• create_metadata_table
• create_normalized_tables
• create_tiles_with_hash_view
• detach_db
  Execute DETACH DATABASE command
• get_bsdiff_tbl_name
• get_patch_type
  Check if MBTiles has a table or a view named bsdiffraw or bsdiffrawgz with needed fields, and return the corresponding patch type. If missing, return PatchType::Whole
• has_tiles_with_hash
  Check if MBTiles has a table or a view named tiles_with_hash with needed fields
• init_mbtiles_schema
• invert_y_value
  MBTiles uses a TMS (Tile Map Service) scheme for its tile coordinates (inverted along the Y axis). This function converts Y value between TMS tile coordinate to an XYZ tile coordinate.
• is_empty_database
  Returns true if the database is empty (no tables/indexes/…)
• is_flat_tables_type
• is_flat_with_hash_tables_type
• is_normalized_tables_type
• reset_db_settings

Type Aliases

• MbtResult