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

A reference to an MBTiles file providing low-level database operations.

MbtilesCopier

MbtilesPool

Connection pool for concurrent read access to an MBTiles file.

Metadata

Tileset metadata combining MBTiles and TileJSON specifications.

TileCoord

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

anonymous_mbtiles

Create an in memory, temporary mbtile connection with the given script

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

temp_named_mbtiles

Create a named, in memory, temporary mbtile connection with the given script

Type Aliases

MbtResult

Tile