Expand description
kml
Rust support for reading and writing KML with a focus on conversion to geo-types
primitives.
Examples
Reading
use std::path::Path;
use kml::{Kml, KmlReader};
let kml_str = r#"
<Polygon>
<outerBoundaryIs>
<LinearRing>
<tessellate>1</tessellate>
<coordinates>
-1,2,0
-1.5,3,0
-1.5,2,0
-1,2,0
</coordinates>
</LinearRing>
</outerBoundaryIs>
</Polygon>
"#;
// Parse from a string
let kml: Kml = kml_str.parse().unwrap();
// Read from a file path
let kml_path = Path::new(env!("CARGO_MANIFEST_DIR"))
.join("tests")
.join("fixtures")
.join("polygon.kml");
let mut kml_reader = KmlReader::<_, f64>::from_path(kml_path).unwrap();
let kml_data = kml_reader.read().unwrap();
// Read KMZ files with the `zip` feature or default features enabled
let kmz_path = Path::new(env!("CARGO_MANIFEST_DIR"))
.join("tests")
.join("fixtures")
.join("polygon.kmz");
let mut kmz_reader = KmlReader::<_, f64>::from_kmz_path(kmz_path).unwrap();
let kmz_data = kmz_reader.read().unwrap();
Writing
use std::str;
use quick_xml;
use kml::{Kml, KmlWriter, types::{AltitudeMode, Coord, Point}};
let kml = Kml::Point(Point::new(1., 1., None));
let mut buf = Vec::new();
let mut writer = KmlWriter::from_writer(&mut buf);
writer.write(&kml).unwrap();
Conversion
use geo_types::{self, GeometryCollection};
use kml::{quick_collection, Kml, types::Point};
let kml_point = Point::new(1., 1., None);
// Convert into geo_types primitives
let geo_point = geo_types::Point::from(kml_point);
// Convert back into kml::types structs
let kml_point = Point::from(geo_point);
let kml_folder_str = r#"
<Folder>
<Point>
<coordinates>1,1,1</coordinates>
<altitudeMode>relativeToGround</altitudeMode>
</Point>
<LineString>
<coordinates>1,1 2,1 3,1</coordinates>
<altitudeMode>relativeToGround</altitudeMode>
</LineString>
</Folder>"#;
let kml_folder: Kml<f64> = kml_folder_str.parse().unwrap();
// Use the quick_collection helper to convert Kml to a geo_types::GeometryCollection
let geom_coll: GeometryCollection<f64> = quick_collection(kml_folder).unwrap();
Re-exports
pub use crate::reader::KmlReader;
pub use crate::writer::KmlWriter;
pub use conversion::quick_collection;
geo-types
Modules
Module for converting KML geometry elements to and from
geo-types
primitivesModule for reading KML sources into Rust types
Module containing types for KML elements
Module for writing KML types
Structs
Container for KML root element
Enums
Errors for KML reading and writing
Enum for representing any KML element
Enum for representing the KML version being parsed