geo-coding 0.1.0

Offline reverse geocoder that uses files derived from OSM data.
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

use alloc::vec::Vec;
use core::mem::size_of;

pub trait Read {
    fn read_u32(&mut self) -> std::io::Result<u32> {
        let mut buf = [0; 4];
        self.read_bytes(&mut buf[..])?;
        Ok(u32::from_le_bytes(buf))
    }

    fn read_bytes(&mut self, buf: &mut [u8]) -> std::io::Result<()>;
    fn read_sign_magnitude(&mut self, count: usize) -> std::io::Result<Vec<i64>>;
    fn read_magnitude_monotonic(&mut self, count: usize) -> std::io::Result<Vec<u32>>;
    fn read_magnitude(&mut self, count: usize) -> std::io::Result<Vec<u32>>;
}

impl<R: std::io::Read> Read for R {
    fn read_bytes(&mut self, buf: &mut [u8]) -> std::io::Result<()> {
        self.read_exact(buf)
    }

    fn read_sign_magnitude(&mut self, count: usize) -> std::io::Result<Vec<i64>> {
        const MAX_BYTES: usize = size_of::<u64>();
        let mut values = Vec::with_capacity(count);
        if count == 0 {
            return Ok(values);
        }
        let mut buf = [0_u8; MAX_BYTES];
        self.read_exact(&mut buf[..1])?;
        let num_bytes = buf[0];
        if num_bytes == 0 || usize::from(num_bytes) > MAX_BYTES {
            return Err(std::io::ErrorKind::InvalidData.into());
        }
        // Read magnitudes.
        for _ in 0..count {
            self.read_exact(&mut buf[..usize::from(num_bytes)])?;
            let magnitude = u64::from_le_bytes(buf);
            values.push(magnitude as i64);
        }
        // Read signs.
        let mut prev = 0_i64;
        for magnitude in values.iter_mut() {
            self.read_exact(&mut buf[..1])?;
            let sign = buf[0];
            match sign {
                0 => {}
                1 if *magnitude == i64::MIN => {}
                1 => *magnitude = -*magnitude,
                _ => return Err(std::io::ErrorKind::InvalidData.into()),
            }
            *magnitude = magnitude.wrapping_add(prev);
            prev = *magnitude;
        }
        Ok(values)
    }

    fn read_magnitude_monotonic(&mut self, count: usize) -> std::io::Result<Vec<u32>> {
        const MAX_BYTES: usize = size_of::<u32>();
        let mut values = Vec::with_capacity(count);
        if count == 0 {
            return Ok(values);
        }
        let mut buf = [0_u8; MAX_BYTES];
        self.read_exact(&mut buf[..1])?;
        let num_bytes = buf[0];
        if usize::from(num_bytes) > MAX_BYTES {
            return Err(std::io::ErrorKind::InvalidData.into());
        }
        if num_bytes == 0 {
            values.resize(count, 0_u32);
        }
        // Read magnitudes.
        let mut prev = 0_u32;
        for _ in 0..count {
            self.read_exact(&mut buf[..usize::from(num_bytes)])?;
            let magnitude = u32::from_le_bytes(buf).wrapping_add(prev);
            values.push(magnitude);
            prev = magnitude;
        }
        Ok(values)
    }

    fn read_magnitude(&mut self, count: usize) -> std::io::Result<Vec<u32>> {
        const MAX_BYTES: usize = size_of::<u32>();
        let mut values = Vec::with_capacity(count);
        if count == 0 {
            return Ok(values);
        }
        let mut buf = [0_u8; MAX_BYTES];
        self.read_exact(&mut buf[..1])?;
        let num_bytes = buf[0];
        if usize::from(num_bytes) > MAX_BYTES {
            return Err(std::io::ErrorKind::InvalidData.into());
        }
        if num_bytes == 0 {
            values.resize(count, 0_u32);
        }
        // Read magnitudes.
        for _ in 0..count {
            self.read_exact(&mut buf[..usize::from(num_bytes)])?;
            let magnitude = u32::from_le_bytes(buf);
            values.push(magnitude);
        }
        Ok(values)
    }
}