jsonfg 0.1.0

Types for OGC Features and Geometries JSON (JSON-FG), a GeoJSON superset with support for arbitrary coordinate reference systems, solids, and curved geometries.
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

//! The JSON-FG `FeatureCollection` object.

use serde::{Deserialize, Serialize};

use crate::JsonObject;
use crate::crs::CoordRefSys;
use crate::feature::{Feature, FeatureType};
use crate::measures::Measures;

/// A JSON-FG feature collection.
///
/// Collection-level members such as [`coord_ref_sys`](FeatureCollection::coord_ref_sys)
/// and [`feature_type`](FeatureCollection::feature_type) provide the default for the
/// contained features, which then omit those members. As with [`Feature`], set
/// [`conforms_to`](FeatureCollection::conforms_to) only on this top-level object.
///
/// OGC API members that are not part of core JSON-FG — `links`, `timeStamp`,
/// `numberMatched`, `numberReturned` — are preserved through
/// [`foreign_members`](FeatureCollection::foreign_members).
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
pub struct FeatureCollection {
    #[serde(rename = "type", default)]
    pub kind: FeatureCollectionKind,

    /// Declared conformance classes. Set only on the top-level object of a document.
    #[serde(
        rename = "conformsTo",
        skip_serializing_if = "Option::is_none",
        default
    )]
    pub conforms_to: Option<Vec<String>>,

    #[serde(
        rename = "featureType",
        skip_serializing_if = "Option::is_none",
        default
    )]
    pub feature_type: Option<FeatureType>,

    /// The dimension (0–3) of the geometries in this collection, if uniform.
    #[serde(
        rename = "geometryDimension",
        skip_serializing_if = "Option::is_none",
        default
    )]
    pub geometry_dimension: Option<u8>,

    #[serde(
        rename = "featureSchema",
        skip_serializing_if = "Option::is_none",
        default
    )]
    pub feature_schema: Option<crate::feature::FeatureSchema>,

    /// The default coordinate reference system for the features' `place` geometries.
    #[serde(
        rename = "coordRefSys",
        skip_serializing_if = "Option::is_none",
        default
    )]
    pub coord_ref_sys: Option<CoordRefSys>,

    #[serde(skip_serializing_if = "Option::is_none", default)]
    pub measures: Option<Measures>,

    /// The features. Always serialized (as `[]` when empty).
    pub features: Vec<Feature>,

    /// Any additional members (`links`, `timeStamp`, `numberMatched`, `numberReturned`,
    /// …), preserved verbatim.
    #[serde(flatten)]
    pub foreign_members: JsonObject,
}

impl Default for FeatureCollection {
    fn default() -> Self {
        FeatureCollection {
            kind: FeatureCollectionKind::FeatureCollection,
            conforms_to: None,
            feature_type: None,
            geometry_dimension: None,
            feature_schema: None,
            coord_ref_sys: None,
            measures: None,
            features: Vec::new(),
            foreign_members: JsonObject::new(),
        }
    }
}

impl FeatureCollection {
    /// A new, empty feature collection.
    pub fn new() -> Self {
        FeatureCollection::default()
    }
}

impl FromIterator<Feature> for FeatureCollection {
    fn from_iter<I: IntoIterator<Item = Feature>>(iter: I) -> Self {
        FeatureCollection {
            features: iter.into_iter().collect(),
            ..Default::default()
        }
    }
}

/// Marker for the `type` member of a [`FeatureCollection`]; always serializes as
/// `"FeatureCollection"`.
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Serialize, Deserialize)]
pub enum FeatureCollectionKind {
    #[default]
    FeatureCollection,
}