# Rustial
Scientific-grade 2.5D geospatial map library for Rust.
## Features
- WGS-84 geodetic coordinates with Web Mercator projection
- 2.5D camera with orthographic and perspective modes
- Cross-platform rendering via WGPU (Vulkan, Metal, DX12, WebGPU)
- Optional Bevy Engine integration
## Quick Start
```rust
use rustial::{MapBuilder, MapHandle};
let state = MapBuilder::new()
.center(51.09916, 17.03664)
.zoom(10)
.viewport(1280, 720)
.build();
let handle = MapHandle::new(state);
assert_eq!(handle.read().camera.zoom, 10.0);
```
## Feature Flags
| `wgpu-renderer` | yes | Enables the pure WGPU renderer integration. |
| `bevy-renderer` | no | Enables the Bevy renderer integration. |
| `geojson` | no | Enables GeoJSON parsing support. |
| `style-json` | no | Enables style-document parsing support. |
| `disk-cache` | no | Enables on-disk tile caching support. |
| `gltf` | no | Enables glTF model loading support. |
| `obj` | no | Enables OBJ model loading support. |
| `shapefile` | no | Enables ESRI Shapefile parsing support. |
| `terrain-rgb` | no | Enables built-in Terrain-RGB helpers. |