Struct FeatureCollection 

pub struct FeatureCollection {
    pub bbox: Option<Bbox>,
    pub features: Vec<Feature>,
    pub foreign_members: Option<JsonObject>,
}

Feature Collection Object

GeoJSON Format Specification § 3.3

Examples

Serialization:

use geojson::FeatureCollection;
use geojson::GeoJson;

let feature_collection = FeatureCollection {
    bbox: None,
    features: vec![],
    foreign_members: None,
};

let serialized = feature_collection.to_string();
assert_eq!(serialized, r#"{"type":"FeatureCollection","features":[]}"#);

Deserializing a GeoJSON string into a FeatureCollection:

use geojson::{FeatureCollection, Feature, Geometry};

let geojson_str = r#"
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [-1.0, -2.0]
      }
    }
  ]
}"#;

let feature_collection = geojson_str
    .parse::<FeatureCollection>()
    .expect("valid FeatureCollection GeoJSON");

let expected = FeatureCollection::new([
    Feature::from(Geometry::new_point([-1.0, -2.0]))
]);
assert_eq!(feature_collection, expected);

Collect from an iterator:

use geojson::{Feature, FeatureCollection, Geometry};

let fc: FeatureCollection = (0..10)
    .map(|idx| -> Feature {
        let c = idx as f64;
        Geometry::new_point([1.0 * c, 2.0 * c, 3.0 * c]).into()
    })
    .collect();
assert_eq!(fc.features.len(), 10);

Fields

bbox: Option<Bbox>

Bounding Box

GeoJSON Format Specification § 5

features: Vec<Feature>

foreign_members: Option<JsonObject>

Foreign Members

GeoJSON Format Specification § 6

See the crate-level foreign members documentation for details, including limitations on key names.

Implementations

impl FeatureCollection

pub fn new(features: impl IntoIterator<Item = Feature>) -> Self

Construct a FeatureCollection from an iterator of Features (or things that can be turned Into a Feature)

Trait Implementations

impl Clone for FeatureCollection

fn clone(&self) -> FeatureCollection

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FeatureCollection

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FeatureCollection

fn default() -> FeatureCollection

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FeatureCollection

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for FeatureCollection

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T> From<&GeometryCollection<T>> for FeatureCollection

where T: CoordFloat,

Available on crate feature geo-types only.

fn from(geometry_collection: &GeometryCollection<T>) -> Self

Converts to this type from the input type.

impl From<FeatureCollection> for GeoJson

fn from(feature_collection: FeatureCollection) -> GeoJson

Converts to this type from the input type.

impl FromIterator<Feature> for FeatureCollection

Create a FeatureCollection using the collect method on an iterator of Features. If every item contains a bounding-box of the same dimension, then the output has a bounding-box of the union of them. Otherwise, the output will not have a bounding-box.

fn from_iter<T: IntoIterator<Item = Feature>>(iter: T) -> Self

Creates a value from an iterator.

impl FromStr for FeatureCollection

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self>

Parses a string s to return a value of this type.

impl IntoIterator for FeatureCollection

type Item = Feature

The type of the elements being iterated over.

type IntoIter = IntoIter<Feature>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for &'a FeatureCollection

type Item = &'a Feature

The type of the elements being iterated over.

type IntoIter = Iter<'a, Feature>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for FeatureCollection

fn eq(&self, other: &FeatureCollection) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for FeatureCollection

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FeatureCollection

impl<T> TryFrom<FeatureCollection> for Geometry<T>

where T: CoordFloat,

Available on crate feature geo-types only.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(val: FeatureCollection) -> Result<Geometry<T>>

Performs the conversion.

impl TryFrom<GeoJson> for FeatureCollection

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: GeoJson) -> Result<Self>

Performs the conversion.