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

use std::collections::HashMap;

use chrono::NaiveDateTime;
use rust_decimal::Decimal;

/// Fundamental representation of geographic features in OpenStreetMap
#[derive(Debug, PartialEq, Eq, Clone)]
pub enum Element {
    Node(Node),
    Way(Way),
    Relation(Relation),
}

/// Opaque node identifiers
#[derive(Debug, PartialEq, Eq, Clone, Hash)]
pub struct Id(i64);

/// Single point in space
///
/// <https://wiki.openstreetmap.org/wiki/Node>
#[derive(Debug, PartialEq, Eq, Clone)]
pub struct Node {
    pub id: Id,
    pub attributes: HashMap<String, String>,
    pub info: Option<Info>,
    pub lat: Decimal,
    pub lon: Decimal,
}

/// Ordered list of [Node]s
///
/// <https://wiki.openstreetmap.org/wiki/Way>
#[derive(Debug, PartialEq, Eq, Clone)]
pub struct Way {
    pub id: Id,
    pub attributes: HashMap<String, String>,
    pub info: Option<Info>,
    pub refs: Vec<Id>,
}

/// Ordered list of [Element]s
///
/// <https://wiki.openstreetmap.org/wiki/Relation>
#[derive(Debug, PartialEq, Eq, Clone)]
pub struct Relation {
    pub id: Id,
    pub attributes: HashMap<String, String>,
    pub info: Option<Info>,
    pub members: Vec<Member>,
}

/// [Element] in a [Relation]
#[derive(Debug, PartialEq, Eq, Clone, Hash)]
pub struct Member {
    pub id: Id,
    pub ty: MemberType,
    /// <https://wiki.openstreetmap.org/wiki/Relation#Roles>
    pub role: Option<String>,
}

/// Type of [Element] represented by [Member]
#[derive(Debug, PartialEq, Eq, Clone, Hash)]
pub enum MemberType {
    Node,
    Way,
    Relation,
}

/// Non-geographical information about a [Element]
#[derive(Debug, PartialEq, Eq, Clone, Hash)]
pub struct Info {
    /// Version number of this revision of the [Element]
    pub version: i32,
    /// Time of last edit
    pub timestamp: Option<NaiveDateTime>,
    /// Group of edits that this version belongs to
    /// 
    /// <https://wiki.openstreetmap.org/wiki/Changeset>
    pub changeset: Option<i64>,
    /// User ID
    pub uid: Option<i32>,
    /// Username
    pub user: Option<String>,
    /// Whether a [Element] is visible or not
    ///
    /// Assume this to be true if it is [None]. If [Some(false)], the [Element] was deleted.
    pub visible: Option<bool>,
}