h3o 0.10.0

A Rust implementation of the H3 geospatial indexing system.
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 h3o::DirectedEdgeIndex;

#[test]
fn display() {
    let index = DirectedEdgeIndex::try_from(0x13a194e699ab7fff).expect("edge");
    let result = index.boundary().to_string();
    let expected =
        "[(51.5333297603, 0.0043462775)-(51.5328604873, 0.0051280949)]"
            .to_owned();

    assert_eq!(result, expected);
}

#[cfg(feature = "geo")]
#[test]
fn edge_boundary_geo_traits_support() {
    use geo_traits::{
        GeometryTrait as _, LineStringTrait as _, PolygonTrait as _,
    };

    let edge = DirectedEdgeIndex::try_from(0x13a194e699ab7fff).expect("edge");
    let boundary = edge.boundary();

    // Boundary implements the LineStringTrait.
    assert_eq!(boundary.num_coords(), 2);
    assert_eq!(boundary[0], boundary.coord(0).unwrap());

    // But is not a useful PolygonTrait.
    assert!(boundary.exterior().is_none());

    // And GeometryTrait.
    assert!(matches!(
        boundary.as_type(),
        geo_traits::GeometryType::LineString(_)
    ));
    assert_eq!(boundary.dim(), geo_traits::Dimensions::Xy);
}

#[cfg(feature = "geo")]
#[test]
fn cell_boundary_geo_traits_support() {
    use geo_traits::{
        GeometryTrait as _, LineStringTrait as _, PolygonTrait as _,
    };

    let index = h3o::CellIndex::try_from(0x813b7ffffffffff).unwrap();
    let boundary = index.boundary();

    // Boundary implements the LineStringTrait, but return a closed ring.
    assert_eq!(boundary.num_coords(), 7);
    assert_eq!(boundary.coord(0), boundary.coord(6));

    // Boundary implements the PolygonTrait.
    assert!(boundary.exterior().is_some());
    assert_eq!(boundary.num_interiors(), 0);

    // And GeometryTrait.
    assert!(matches!(
        boundary.as_type(),
        geo_traits::GeometryType::Polygon(_)
    ));
    assert_eq!(boundary.dim(), geo_traits::Dimensions::Xy);
}

#[cfg(feature = "geo")]
#[test]
#[should_panic]
fn geo_traits_support_polygon_no_interior() {
    use geo_traits::PolygonTrait as _;

    let index = h3o::CellIndex::try_from(0x813b7ffffffffff).unwrap();
    let boundary = index.boundary();

    unsafe {
        boundary.interior_unchecked(0);
    }
}