qbin 0.2.0

Encoding and decoding geographical coordinates to and from Quadbin, a hierarchical geospatial indexing system for square cells in Web Mercator projection developed by Carto. An improved version of Microsoft's Bing Maps Tile System, aka Quadkey.
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

use crate::Direction;
use crate::cells::*;
use crate::errors::QuadbinError;
use crate::utils::*;

/// A single tile coordinates
///
/// _Internal struct_
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
pub(crate) struct Tile {
    pub x: u32,
    pub y: u32,
    pub z: u8,
}

impl Tile {
    /// Create a new tile.
    pub fn new(x: u32, y: u32, z: u8) -> Tile {
        Tile { x, y, z }
    }

    /// Convert to Quadbin cell.
    pub fn to_cell(self) -> Result<Cell, QuadbinError> {
        tile_to_cell(self)
    }

    /// Compute the tile for a longitude and latitude in a specific resolution.
    pub fn from_point(lat: f64, lng: f64, res: u8) -> Result<Self, QuadbinError> {
        point_to_tile(lat, lng, res)
    }

    /// Approximate tile area in square meters.
    pub fn area(&self) -> f64 {
        tile_area(self)
    }

    /// Return tile's latitude.
    ///
    /// See also [Tile::to_longitude].
    ///
    pub fn to_latitude(self, offset: f64) -> Option<f64> {
        tile_to_latitude(&self, offset).ok()
    }

    /// Return tile's longitude.
    ///
    /// See also [Tile::to_latitude].
    ///
    pub fn to_longitude(self, offset: f64) -> Option<f64> {
        tile_to_longitude(&self, offset).ok()
    }

    /// Get tile's siblings.
    pub fn neighbor(&self, direction: Direction) -> Option<Self> {
        tile_neighbor(self, direction)
    }

    // /// Compute a hash from the tile.
    // #[allow(dead_code)]
    // pub fn to_hash(self) -> u64 {
    //     to_tile_hash(&self)
    // }

    // /// Compute a tile from the hash.
    // #[allow(dead_code)]
    // pub fn from_hash(tile_hash: u64) -> Tile {
    //     from_tile_hash(tile_hash)
    // }
}