earthwyrm-bin

Crates.ioearthwyrm-bin
lib.rsearthwyrm-bin
version0.8.0
sourcesrc
created_at2024-01-11 20:27:34.79362
updated_at2024-06-03 18:08:11.574178
descriptionVector tile map server using MVT
homepage
repositoryhttps://github.com/DougLau/earthwyrm/earthwyrm-bin
max_upload_size
id1096636
size51,705
Douglas Lau (DougLau)

documentation

README

EarthWyrm is an open-source map server developed for the Minnesota Department of Transportation (MnDOT). It can serve GIS data from OpenStreetMap or other sources.

Features:

  • Layers configurable by zoom level
  • Web Mercator projection (EPSG:3857)
  • Vector tiles in MVT format, with Z/X/Y.mvt naming convention
  • Quick setup in under 10 minutes

πŸ‘‰ Install using cargo (tested on Fedora Linux):

cargo install earthwyrm-bin
sudo bash
Β«enter password at promptΒ»
install ~/.cargo/bin/earthwyrm /usr/local/bin/
useradd --system -m -b /var/local earthwyrm
sudo -i -u earthwyrm /usr/local/bin/earthwyrm init

This file tree will be created:

/var/local/earthwyrm/
β”œβ”€β”€ earthwyrm.muon
β”œβ”€β”€ earthwyrm.service
β”œβ”€β”€ loam/
└── osm/

πŸ‘‰ Edit the configuration file at /var/local/earthwyrm/earthwyrm.muon. It contains examples and instructions.

πŸ‘‰ Download an OpenStreetMap extract of your region in PBF format into the /var/local/earthwyrm/osm/ directory. For example, files such as minnesota-latest.osm.pbf are provided daily from Geofabrik.

πŸ‘‰ Dig the configured layers into .loam cache files:

sudo -i -u earthwyrm /usr/local/bin/earthwyrm dig

NOTE: This step may take a while, depending on the region size.

πŸ‘‰ Configure systemd service

cp /var/local/earthwyrm/earthwyrm.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable earthwyrm
systemctl start earthwyrm

πŸ‘‰ Test

From the server host, browse to 127.0.0.1:3030

Commit count: 175

cargo fmt