https://github.com/2m/openmower-map-tiles
Map Tile server for OpenMower
https://github.com/2m/openmower-map-tiles
Last synced: 10 months ago
JSON representation
Map Tile server for OpenMower
- Host: GitHub
- URL: https://github.com/2m/openmower-map-tiles
- Owner: 2m
- License: gpl-3.0
- Created: 2023-08-23T15:49:13.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-01T11:56:44.000Z (about 1 year ago)
- Last Synced: 2025-04-06T09:31:42.217Z (about 1 year ago)
- Language: Shell
- Size: 9.39 MB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OpenMower Map Tiles
This repository contains configuration for the [terracotta][] XYZ tile server for custom [OpenMower][openmower] maps.
![demo][]
[terracotta]: https://github.com/DHI-GRAS/terracotta
[openmower]: https://openmower.de/
[demo]: ./docs/demo.png
# Usage
## Taking pictures with a drone
If your drone is supported by mission control software like [Map Pilot Pro][map-pilot-pro], [QGroundControl][qgroundcontrol] or others, you can use these tools to create a mission. However it is perfectly fine to manually fly the drone and take pictures. You can get pretty good results by flying at 30m to 40m altitude and taking pictures every couple of meters.
## Stiching the pictures to a single ortophoto
Place all of the pictures in a single directory like `.//images/`. Then run [OpenDroneMap][odm] to create a single ortophoto:
```bash
docker run -ti --rm -v $PWD:/datasets opendronemap/odm \
--project-path /datasets \
--dsm --orthophoto-resolution 1
```
After it is done, you should have a `.//odm_orthophoto/odm_orthophoto.tif` file. As a bonus, `odm` also creates 3D models and point clouds of the area. Check them out, they are prety cool. :)
## Running XYZ tile server
Now you can start the XYZ tile server from this repository:
```bash
docker run -it --rm \
-v :/tiles/map.tif \
-p 5000:5000 \
-p 5010:5010 \
ghcr.io/2m/openmower-map-tiles:main
```
This will split the given TIF file to different color bands (required by `terracotta`) and start both, the tile server and the preview GUI.
You might see the following warning during tile ingestion:
```
UserWarning: Raster file /tiles/optimized/map_alpha.tif does not have a valid nodata value, and does not contain an alpha band. No data will be masked.
```
That is fine. I did not find the reason for this warning, and it does not affect the tile server.
Open preview GUI on `http://localhost:5010` and select `alpha` in the Bands list. Then select `rgb` in the `Customize layer` dropdown. Assign R, G and B bands their corresponding values and you should see the map.
![preview][]
You can also click the icon on the left that changes the base map to satellite view and see how your map alligns with it. Use `OFFSET_X` and `OFFSET_Y` environment variables to adjust the map if needed. However aligning your map with the satellite view might not be a good idea, since your mower might still be misaligned with both these maps. So better create some mowing zones in OpenMower and then align the map with them in OpenMower GUI.
Use the following tile server URL value with placeholders `http://localhost:5000/rgb/{z}/{x}/{y}.png?r=red&g=green&b=blue` for the tile server configuration in OpenMower GUI or Grafana.
You can also try to manually fetch a single tile to see if it works. First, you need to find out the tile coordinates to use with the server. Go to [What the Quad][what-the-quad], select large zoom level (usually 20) and navigate to a place where you took your ortophoto. You will see Tile Z, X and Y values in the box. Replace the placeholders from above URL with these values and open the URL in your browser. You should see a single tile.
[map-pilot-pro]: https://dronesmadeeasy.com/map-pilot
[qgroundcontrol]: http://qgroundcontrol.com/
[odm]: https://github.com/OpenDroneMap/ODM
[preview]: ./docs/preview.png
[what-the-quad]: https://mvexel.github.io/whatthequad/
## Running on the OpenMower
Copy the ortophoto file `odm_orthophoto.tif` to the OpenMower:
```bash
scp odm_orthophoto.tif openmower@openmower.local:
```
Copy the [`map-tiles.service`][map-tiles-service] file in `/etc/systemd/system/` on your OpenMower.
If you want to use the Terracotta preview GUI from the OpenMower, you will have to set the OpenMower IP address in the `ExecStart` command:
```bash
--env TILE_SERVER="" \
```
You can also run the tile server with TLS. This is useful if you want to access the tile server from a browser page which was retrieved using TLS as well (e.g. Grafana served via TLS). To do this, add the following environment variables to the `ExecStart` command:
```bash
--env TILE_SERVER="" \
--env CF_API_TOKEN="" \
```
This will use [ACME DNS challenge](dns-challenge) to get a valid certificate. Tile server running under TLS will be available at `https://:5443`.
Then enable and start the service:
```bash
sudo systemctl enable map-tiles.service
sudo systemctl start map-tiles.service
```
[map-tiles-service]: ./map-tiles.service
[dns-challenge]: https://caddyserver.com/docs/automatic-https#dns-challenge
## Using Map Tile server with [openmower-gui][]
Once you have XYZ tile server running on the OpenMower, you can configure [OpenMower GUI][openmower-gui] to use it.
Open `/etc/systemd/system/gui.service` and add the following lines to the `ExecStart` command:
```bash
--env MAP_TILE_SERVER=http://localhost:5000 \
--env MAP_TILE_URI="/tiles/rgb/{z}/{x}/{y}.png?r=red&g=green&b=blue" \
```
Now open the GUI and you should see custom tiles on the Map page.
![map][]
[openmower-gui]: https://github.com/cedbossneo/openmower-gui
[map]: ./docs/map.png
## Using Map Tile server with Grafana
You can configure OpenMower to [send telemetry data to an external MQTT server][mqtt-server].
From there, it is quite easy to [setup Home Assistant sensors][home-assistant] and Grafana dashboards to display the data.
Choose `Geomap` panel type and configure it to use the `XYZ Tile Layer` for `Basemap layer`. Use the following URL for `URL Template`:
```bash
http://:5000/rgb/{z}/{x}/{y}.png?r=red&g=green&b=blue
```
Or the following URL if you configured the tile server to use TLS:
```bash
https://:5443/rgb/{z}/{x}/{y}.png?r=red&g=green&b=blue
```
Note that basemap layer will only work when you access Grafana from the same network as the OpenMower. For remote accessing OpenMower, consider installing [Tailscale][tailscale] on it.
![grafana][]
[mqtt-server]: https://github.com/ClemensElflein/open_mower_ros/blob/main/src/open_mower/config/mower_config.sh.example#L130-L135
[home-assistant]: https://github.com/2m/hassio-config/blob/ginkunai/packages/openmower.yaml
[tailscale]: https://tailscale.com/
[grafana]: ./docs/grafana.png