Skip to content

UdHo/mapvas

Repository files navigation

MapVas

CI codecov Crates.io Downloads License

A map canvas that shows all kind of geospatial data on an interactive map.

mapvas

Install

Cargo:

cargo install mapvas

macOS (Homebrew):

brew tap udho/mapvas && brew install mapvas

From source:

git clone https://github.com/UdHo/mapvas.git
cd mapvas && cargo install --path .

Quick Start

View a file:

mapcat data.geojson
mapcat routes.gpx
mapcat points.kml

Pipe data:

echo "52.521853, 13.413015" | mapcat          # Point in Berlin
curl 'https://api.example.com/geo' | mapcat   # From API

Or just drag and drop files onto the map window.

Heatmap

Render point data as a colour-gradient heatmap instead of individual shapes:

# All inputs as heatmap
mapcat -H points.geojson

# Mix: one file as heatmap, another normal
mapcat routes.geojson points.geojson:heatmap

# Headless heatmap
mapcat -o map.png -H points.geojson

Headless Rendering

Render maps directly to PNG without opening a window:

# Render a file
mapcat -o map.png data.geojson

# Multiple files
mapcat -o map.png routes.geojson points.geojson

# Pipe data
cat data.geojson | mapcat -o map.png

# Custom image size
mapcat -o map.png data.geojson --width 3200 --height 2400

# Black background, no map tiles
mapcat -o map.png --no-map data.geojson

Basic Controls

Action Description
Scroll / +/- Zoom
Drag Pan
V Paste coordinates
Drop file Load data
F Focus all elements
/ Search
F1 Toggle sidebar

Neovim

mapvas.nvim provides a Neovim plugin with commands to send buffers/selections to the map, coordinate highlighting, auto send-on-save, and a layer explorer sidebar.

Documentation

  • Usage Guide - Full controls and features
  • Parsers - Supported formats (GeoJSON, GPX, KML, etc.)
  • Configuration - Tile providers, caching, environment variables

License

MIT OR Apache-2.0

About

A hackable map viewer to draw geometry on.

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE.txt
MIT
LICENSE-MIT.txt

Stars

Watchers

Forks

Packages

 
 
 

Contributors