12 releases

0.6.2 Oct 29, 2024
0.6.1 May 19, 2024
0.6.0 Apr 30, 2024
0.5.2 Jun 16, 2023
0.2.1 Jul 29, 2019

#37 in Geospatial

Download history 125/week @ 2024-07-18 61/week @ 2024-07-25 160/week @ 2024-08-01 105/week @ 2024-08-08 100/week @ 2024-08-15 88/week @ 2024-08-22 140/week @ 2024-08-29 108/week @ 2024-09-05 91/week @ 2024-09-12 127/week @ 2024-09-19 86/week @ 2024-09-26 142/week @ 2024-10-03 145/week @ 2024-10-10 183/week @ 2024-10-17 290/week @ 2024-10-24 274/week @ 2024-10-31

947 downloads per month
Used in 5 crates (3 directly)

MIT license

99KB
2K SLoC

tile-grid

Crates.io Documentation

tile-grid is a library for using OGC TileMatrixSets (TMS).

tile-grid follows the OGC Two Dimensional Tile Matrix Set specification found in https://docs.ogc.org/is/17-083r4/17-083r4.html

Note: Variable matrix width tile set are not supported.

Usage

Load tile set matrix and get bounds of a tile

use tile_grid::{tms, BoundingBox, Xyz};

let tms = tms().lookup("WebMercatorQuad").unwrap();

// Get the bounds for tile Z=4, X=10, Y=10 in the input projection
let bounds = tms.xy_bounds(&Xyz::new(10, 10, 4));
assert_eq!(
    bounds,
    BoundingBox::new(
        5009377.085697308,
        -7514065.628545959,
        7514065.628545959,
        -5009377.085697308
    )
);

// Get the bounds for tile Z=4, X=10, Y=10 in LatLon (WGS84)
let bounds = tms.bounds(&Xyz::new(10, 10, 4)).unwrap();
assert_eq!(
    bounds,
    BoundingBox::new(45.0, -55.77657301866769, 67.5, -40.97989806962013)
);

Find tile for lat/lon

use tile_grid::{tms, Xyz};

let tms = tms().lookup("WebMercatorQuad").unwrap();

let tile = tms.tile(159.31, -42.0, 4).unwrap();
assert_eq!(tile, Xyz::new(15, 10, 4));

// Or using coordinates in input CRS
let tile = tms.xy_tile(17734308.1, -5160979.4, 4);
assert_eq!(tile, Xyz::new(15, 10, 4));

Credits

License

tile-grid is released under the MIT License.

Dependencies

~5–8.5MB
~131K SLoC