utiles 0.8.0

Web map tile utils (aka utiles)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

use async_trait::async_trait;
use tilejson::TileJSON;

use crate::errors::UtilesResult;
use crate::mbt::{MbtMetadataRow, MbtType, MbtilesStats, MetadataChangeFromTo};
use crate::mbt::{MbtilesMetadataJson, MinZoomMaxZoom};
use crate::sqlite::RowsAffected;
use utiles_core::tile_type::TileKind;
use utiles_core::{BBox, Tile, TileLike};

#[async_trait]
pub trait MbtilesAsync: Sized {
    fn filepath(&self) -> &str;
    fn filename(&self) -> &str;

    async fn register_utiles_sqlite_functions(&self) -> UtilesResult<()>;
    async fn is_mbtiles_like(&self) -> UtilesResult<bool>;
    async fn is_mbtiles(&self) -> UtilesResult<bool>;
    async fn assert_mbtiles(&self) -> UtilesResult<()>;
    async fn magic_number(&self) -> UtilesResult<u32>;
    async fn tilejson(&self) -> UtilesResult<TileJSON>;
    async fn metadata_rows(&self) -> UtilesResult<Vec<MbtMetadataRow>>;

    async fn metadata_json(&self) -> UtilesResult<MbtilesMetadataJson>;

    /// Returns the metadata row struct for the given name
    async fn metadata_row(&self, name: &str) -> UtilesResult<Option<MbtMetadataRow>>;
    async fn metadata_set(&self, name: &str, value: &str) -> UtilesResult<usize>;
    async fn tiles_is_empty(&self) -> UtilesResult<bool>;

    async fn metadata_minzoom(&self) -> UtilesResult<Option<u8>>;
    async fn metadata_maxzoom(&self) -> UtilesResult<Option<u8>>;

    async fn has_zxy(&self, z: u8, x: u32, y: u32) -> UtilesResult<bool>;
    async fn query_zxy(&self, z: u8, x: u32, y: u32) -> UtilesResult<Option<Vec<u8>>>;

    async fn query_tile(&self, tile: &Tile) -> UtilesResult<Option<Vec<u8>>> {
        self.query_zxy(tile.z(), tile.x(), tile.y()).await
    }

    async fn has_tile(&self, tile: &Tile) -> UtilesResult<bool> {
        self.has_zxy(tile.z(), tile.x(), tile.y()).await
    }

    async fn query_minzoom_maxzoom(&self) -> UtilesResult<Option<MinZoomMaxZoom>>;
    async fn query_tilelike<T: TileLike + Send>(
        &self,
        tile: T,
    ) -> UtilesResult<Option<Vec<u8>>> {
        self.query_zxy(tile.z(), tile.x(), tile.y()).await
    }
    async fn tilejson_ext(&self) -> UtilesResult<TileJSON>;

    async fn query_mbt_type(&self) -> UtilesResult<MbtType>;
    async fn bbox(&self) -> UtilesResult<BBox>;

    async fn zxyify(&self) -> UtilesResult<Vec<RowsAffected>>;

    async fn mbt_stats(&self, full: Option<bool>) -> UtilesResult<MbtilesStats>;

    async fn tiles_count(&self) -> UtilesResult<usize>;
    async fn pragma_encoding(&self) -> UtilesResult<String>;
    async fn metadata_update(
        &self,
        name: &str,
        value: &str,
    ) -> UtilesResult<Option<MetadataChangeFromTo>>;
    async fn update_minzoom_maxzoom(
        &self,
    ) -> UtilesResult<Option<Vec<MetadataChangeFromTo>>>;
    async fn metadata_duplicate_key_values(
        &self,
    ) -> UtilesResult<Vec<(String, String, usize)>>;
    async fn query_tilekind(&self) -> UtilesResult<TileKind>;
    async fn query_metadata_value(&self, name: &str) -> UtilesResult<Option<String>>;
    async fn query_metadata_format(&self) -> UtilesResult<Option<String>>;
}