#geo-json #geospatial #data-source #deserializing #geometry #deserialize #geozero

serde_geozero

A Rust library for serializing and deserializing geospatial data using serde and geozero

3 releases

0.1.2 Feb 20, 2025
0.1.1 Jan 16, 2025
0.1.0 Jan 16, 2025

#76 in Geospatial

Download history 115/week @ 2025-01-10 158/week @ 2025-01-17 16/week @ 2025-01-24 28/week @ 2025-01-31 153/week @ 2025-02-07 429/week @ 2025-02-14 351/week @ 2025-02-21 96/week @ 2025-02-28 217/week @ 2025-03-07 129/week @ 2025-03-14

902 downloads per month

MIT/Apache

160KB
807 lines

serde-geozero

A Rust library for serializing and deserializing geospatial data using serde and geozero.

Overview

serde-geozero provides functionality to convert between geospatial data sources and Rust types using serde's serialization framework and geozero's processing capabilities. It enables seamless integration of various geospatial formats like GeoJSON and FlatGeobuf with Rust's type system.

Features

  • Deserialize from various geospatial formats (GeoJSON, FlatGeobuf, etc.) into Rust structs
  • Serialize Rust structs into geospatial formats
  • Support for geometry and property data
  • Type-safe conversion between geospatial and Rust types

Installation

Add this to your Cargo.toml:

[dependencies]
serde-geozero = "0.1.0"

Usage

Deserializing GeoJSON

use serde::Deserialize;
use geo::Geometry;
use serde_geozero::from_datasource;

#[derive(Deserialize)]
struct City {
    geometry: Geometry,
    name: String,
    population: i64,
}

let geojson = r#"{
    "type": "Feature",
    "geometry": {
        "type": "Point",
        "coordinates": [13.4, 52.5]
    },
    "properties": {
        "name": "Berlin",
        "population": 3669495
    }
}"#;

let mut reader = geozero::geojson::GeoJsonReader(geojson.as_bytes());
let cities: Vec<City> = from_datasource(&mut reader).unwrap();

assert_eq!(cities[0].name, "Berlin");

Serializing to GeoJSON

use geo::point;
use geozero::geojson::GeoJsonWriter;
use serde_geozero::to_geozero_datasource;
use hashbrown::HashMap;
use serde_geozero::de::Feature;

// Create a feature
let feature = Feature::new(
    (point! { x: 123.4, y: 345.6 }).into(),
    HashMap::from_iter(vec![
        ("name".to_string(), serde_json::to_value("Location A").unwrap()),
        ("value".to_string(), serde_json::to_value(42).unwrap()),
    ]),
);

// Serialize to GeoJSON
let mut output = Vec::new();
let mut writer = GeoJsonWriter::new(&mut output);
to_geozero_datasource(&[feature], &mut writer).unwrap();

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Dependencies

~9MB
~158K SLoC