versatiles_geometry 4.5.0

A toolbox for converting, checking and serving map tiles in various formats.
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

# versatiles_geometry

Geometric data structures and utilities for the VersaTiles ecosystem.

[![Crates.io](https://img.shields.io/crates/v/versatiles_geometry)](https://crates.io/crates/versatiles_geometry)
[![Documentation](https://docs.rs/versatiles_geometry/badge.svg)](https://docs.rs/versatiles_geometry)

## 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

```sh
cargo add versatiles_geometry
```

Or see [crates.io/crates/versatiles_geometry](https://crates.io/crates/versatiles_geometry) for version info and [docs.rs/versatiles_geometry](https://docs.rs/versatiles_geometry) for API documentation.

### Example

```rust
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](https://docs.rs/versatiles_geometry).

## Part of VersaTiles

This crate is part of the [VersaTiles](https://github.com/versatiles-org/versatiles-rs) 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](https://github.com/versatiles-org/versatiles-rs).

## License

MIT License - see [LICENSE](https://github.com/versatiles-org/versatiles-rs/blob/main/LICENSE) for details.