graphways 0.3.0

Fast OpenStreetMap reachability, routing, and isochrones from Python, powered by Rust — no routing server required.
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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

use geo::Polygon;
use geojson::{GeoJson, Geometry, Value};

pub fn calculate_distance(lat1: f64, lon1: f64, lat2: f64, lon2: f64) -> f64 {
    const EARTH_RADIUS_M: f64 = 6_371_000.0;

    let dlat = (lat2 - lat1).to_radians();
    let dlon = (lon2 - lon1).to_radians();

    let lat1 = lat1.to_radians();
    let lat2 = lat2.to_radians();

    let a = (dlat / 2.0).sin().powi(2) + (dlon / 2.0).sin().powi(2) * lat1.cos() * lat2.cos();
    let c = 2.0 * a.sqrt().min(1.0).asin();

    EARTH_RADIUS_M * c
}

pub fn calculate_travel_time(length: f64, speed_kph: f64) -> f64 {
    if !length.is_finite() || !speed_kph.is_finite() || length < 0.0 || speed_kph <= 0.0 {
        return f64::INFINITY;
    }
    let speed_m_per_s = speed_kph / 3.6;
    length / speed_m_per_s
}

fn ring_to_geojson_coords(ring: &geo::LineString<f64>) -> Vec<Vec<f64>> {
    ring.0
        .iter()
        .map(|coord| vec![coord.y, coord.x])
        .collect::<Vec<_>>()
}

pub fn polygon_to_geojson(polygon: &Polygon<f64>) -> GeoJson {
    // node_to_latlon returns (lat, lon) tuples which geo stores as (x=lat, y=lon).
    // GeoJSON spec requires [longitude, latitude], so coord.y = lon, coord.x = lat.
    let mut rings = Vec::with_capacity(1 + polygon.interiors().len());
    rings.push(ring_to_geojson_coords(polygon.exterior()));
    rings.extend(polygon.interiors().iter().map(ring_to_geojson_coords));

    let geojson_polygon = Geometry::new(Value::Polygon(rings));

    GeoJson::Geometry(geojson_polygon)
}

// Convert polygon to GeoJSON string
pub fn polygon_to_geojson_string(polygon: &Polygon<f64>) -> String {
    let geojson = polygon_to_geojson(polygon);
    geojson.to_string()
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_distance_same_point() {
        let d = calculate_distance(48.0, 11.0, 48.0, 11.0);
        assert_eq!(d, 0.0);
    }

    #[test]
    fn test_distance_known_value() {
        // Munich to roughly 1km north — should be close to 1000m
        let d = calculate_distance(48.0, 11.0, 48.009, 11.0);
        assert!((d - 1000.0).abs() < 10.0, "Expected ~1000m, got {}", d);
    }

    #[test]
    fn test_distance_is_symmetric() {
        let d1 = calculate_distance(48.0, 11.0, 52.0, 13.0);
        let d2 = calculate_distance(52.0, 13.0, 48.0, 11.0);
        assert!((d1 - d2).abs() < 1e-6);
    }

    #[test]
    fn test_travel_time_basic() {
        // 1000m at 36 kph = 100 seconds
        let t = calculate_travel_time(1000.0, 36.0);
        assert!((t - 100.0).abs() < 1e-6, "Expected 100s, got {}", t);
    }

    #[test]
    fn test_travel_time_walking() {
        // 500m at 5 kph = 360 seconds
        let t = calculate_travel_time(500.0, 5.0);
        assert!((t - 360.0).abs() < 1e-6);
    }

    #[test]
    fn test_travel_time_rejects_invalid_speed() {
        assert!(calculate_travel_time(500.0, 0.0).is_infinite());
        assert!(calculate_travel_time(500.0, -10.0).is_infinite());
    }

    #[test]
    fn test_polygon_to_geojson_preserves_interiors() {
        let exterior = geo::LineString::from(vec![
            (0.0, 0.0),
            (10.0, 0.0),
            (10.0, 10.0),
            (0.0, 10.0),
            (0.0, 0.0),
        ]);
        let hole = geo::LineString::from(vec![
            (2.0, 2.0),
            (3.0, 2.0),
            (3.0, 3.0),
            (2.0, 3.0),
            (2.0, 2.0),
        ]);
        let polygon = Polygon::new(exterior, vec![hole]);
        let geojson = polygon_to_geojson(&polygon);

        if let GeoJson::Geometry(Geometry {
            value: Value::Polygon(rings),
            ..
        }) = geojson
        {
            assert_eq!(rings.len(), 2);
        } else {
            panic!("expected GeoJSON polygon");
        }
    }
}