mapvas 0.1.3

A map viewer with drawing functionality
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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

# MapVas

A **map** can**vas** showing [OSM](https://openstreetmap.org) tiles with drawing functionality.
The repo contains two binaries, 
- mapvas: the map window
- mapcat: an equivalent to [cat](https://en.wikipedia.org/wiki/Cat_(Unix)) to draw polygons on the map.

## Setup
Make sure you have the nighly Rust toolchain installed.
- [Install Rust](https://rustup.rs).
- Install the nightly toolchain
```
    rustup toolchain install nightly
```

Manually:
- Clone this repository.
- `cd mapvas ; cargo +nightly install --path .`

Via cargo:
- `cargo +nightly install mapvas`

## Usage
### mapvas
Start `mapvas` and a map window will appear.
![mapvas](https://github.com/UdHo/mapvas/blob/master/mapvas.png)
|Functionality | Description | 
|--------------|-------------|
| zoom         | Use the mouse wheel or +/- |
| moving       | Left mouse and dragging or arrow keys |

### mapcat
Mapcat currently reads only input from stdin and reads it line by line and pipes and uses it using various [parser](https://github.com/UdHo/mapvas/tree/master/src/parser).
It then shows the parsed result on a single instance of mapvas, which it spawns if none is running.

#### Grep (default)
This parser greps for coordinates latitude and longitude as float in a line. In addition it supports colors and filling of polygons.
Examples:
- draws a point at Berlin Alexanderplatz:
```
    echo "52.521853, 13.413015" | mapcat
```
- draws a line between Berlin and Cologne and a red line between Cologne and Amsterdam:
```
    echo "50.942878, 6.957936 52.521853, 13.413015 green\n 50.942878, 6.957936 52.373520, 4.899766 red" | mapcat 
```
- draws a yellow polyline Cologne-Berlin-Amsterdam:
```
    echo "50.942878, 6.957936 random garbage words 52.521853, 13.413015 yellow spaces after the coordinate-comma is not important: 52.373520,4.899766" | mapcat 
```
- draws a blue transparently filled polygon Cologne-Berlin-Amsterdam note that a fill ("transparent" or "solid"):
```
    echo "50.942878, 6.957936 52.521853, 13.413015 52.373520,4.899766 blue transparent" | mapcat 
```
- --invert-coordinates (-i) reverses the order of lat/lon:
```
    echo "13.413015, 52.521853" | mapcat -i 
```
- clears all elements from the map.
```
echo "clear" | mapcat 
```
Filling a polyline causes it to be drawn as closed polygon.

#### Random (for performance testing)
Draws a random polyline of a given length. The following command draws a random walk consisting of 20000 polylines of a random length between 1 and 10.
```
    echo "20000" | mapcat -p random
``` 

#### TTJson
Draws routes or ranges from the [TomTom routing api](https://developer.tomtom.com/routing-api/documentation/routing/routing-service).
```
curl 'https://api.tomtom.com/routing/1...' | mapcat -p ttjson -c green
```

### Advanced usage
#### Offline usage
To cache tile images for future runs set the environment variable `TILECACHE` to an existing directory.
```
    mkdir ~/.tilecache
    export TILECACHE=~/.tilecache
```

#### Several windows
By default only one instance of the map viewer is opened and a second instance won't start unless you specify a window number.
```
    echo "52.1,12.2" | mapcat -w 1 
```
The default window has number 0.