versatiles_geometry

Geometric data structures and utilities for the VersaTiles ecosystem.

Overview

versatiles_geometry provides the geometric data handling layer for VersaTiles, including primitives for working with points, lines, and polygons, as well as support for GeoJSON and Mapbox Vector Tiles (MVT).

This crate is essential for reading, transforming, and exporting geospatial vector data.

Features

Geometry Primitives: Core geometric types including Point, LineString, Polygon, and MultiPolygon
GeoJSON Support: Parse and serialize GeoJSON and newline-delimited GeoJSON (NDGeoJSON)
Vector Tiles: Read and write Mapbox Vector Tile (MVT) protobuf format, with full MVT 2.1 validation and repair
MVT Validation: validate_tile checks for missing extent/version fields, duplicate layer names, polygon winding issues, and degenerate rings
MVT Repair: repair_tile fixes every issue the validator reports in one pass, with an option to drop undecodable features
Tile Outlines: Generate polygonal outlines from tile bounding boxes
Transformations: Convert between different geometric representations

Usage

cargo add versatiles_geometry

Or see crates.io/crates/versatiles_geometry for version info and docs.rs/versatiles_geometry for API documentation.

Example

use versatiles_geometry::{
    geo::{Point, Polygon},
    geojson::GeoJson,
    vector_tile::{VectorTile, validate_tile, repair_tile},
};

// Create geometric primitives
let point = Point::new(13.4, 52.5);

// Parse GeoJSON
let geojson_str = r#"{"type": "Point", "coordinates": [13.4, 52.5]}"#;
let geojson = GeoJson::from_str(geojson_str)?;

// Work with vector tiles (MVT)
let mvt_data: Vec<u8> = /* ... */;
let tile = VectorTile::from_bytes(&mvt_data)?;

// Validate against MVT 2.1 spec
let issues = validate_tile(&tile);
if !issues.is_empty() {
    // Repair: fix structural issues and polygon winding.
    // Pass drop_offenders=true to also remove undecodable features.
    let fixed = repair_tile(tile, false)?;
}

API Documentation

For detailed API documentation, see docs.rs/versatiles_geometry.

Part of VersaTiles

This crate is part of the VersaTiles project, a toolbox for working with map tile containers in various formats.

For the complete toolset including CLI tools and servers, see the main VersaTiles repository.

License

MIT License - see LICENSE for details.

versatiles_geometry 4.6.1