leaflet-galmon/README.md

# Spacecruft Leaflet Galmon
The present repo contains scripts to process data for
viewing with Leaflet maps.

Retrieve Galmon observers and GNSS locations,
output HTML maps with Leaflet.

`galmon-gnssleaflet` is a script to retrieve Galmon
GNSS locations and feed them to Leaflet maps for visualization.


`galmon-observers2leaflet` is a script to retrieve Galmon
observer locations and feed them to Leaflet maps for visualization.


The Galmon GNSS Monitoring Project's 
*"goals are to monitor the major Global Navigation Satellite Systems,
including GPS, GLONASS, Galileo and BeiDou, but also Space Base
Augmentation Systems like WAAS, EGNOS and GAGAN. Galmon is an open
source & open data project with a community of over 30 station operators
running more than 50 receivers."*


*Leaflet is the leading open-source JavaScript library for
mobile-friendly interactive maps.*

# Screenshots
Screenshots of Galmon Observers, generated by `galmon-observers2leaflet`.

*Leaflet with Galmon Observer locations.*
![leaflet-galmon-observers](pics/leaflet-galmon-observers.png)

*Leaflet with Galmon GNSS ("GPS satellite") locations.*
![leaflet-galmon-gnss](pics/leaflet-galmon-gnss.png)


# Install
Install thusly.

If you want to generate your own files:
```
# Quick & dirty Python setup
sudo apt update
sudo apt install python3-pip
pip install --user --upgrade pip
pip install --user -r requirements.txt
```

# Run
Run thusly.

Retrieve Galmon observers, output for Leaflet.
```
git clone https://spacecruft.org/spacecruft/leaflet-galmon
cd leaflet-galmon
./galmon-observers2leaflet > ./html/observers.html
./galmon-gnss2leaflet > ./html/gnss.html
# View in browser or serve with webserver:
firefox ./html/gnss.html
firefox ./html/observers.html
```

# Galmon Data
Galmon data can be retrieved from the website in JSON format.
Available URLs:

Global, overview of data collection:
* https://galmon.eu/global.json

Service Vehicles (Satellites):
* https://galmon.eu/svs.json

Almanac. Can also be queried with `t` time flag:
* https://galmon.eu/almanac.json
* https://galmon.eu/almanac.json?t=1653332121

Observers (Ground Stations):
* https://galmon.eu/observers.json

Coverage:
* https://galmon.eu/cov.json
* https://galmon.eu/cov.json?gps=0&galileo=1&beidou=0&glonass=0

SBAS:
* https://galmon.eu/sbas.json

# See Also
## Spacecruft
Spacecruft:

* https://spacecruft.org/spacecruft/celestia-gnss

* https://spacecruft.org/spacecruft/gnss-earth

## Galmon
Galmon main page:
* https://galmon.eu

Galmon web map:
* https://galmon.eu/geo/

Source code:
* https://github.com/berthubert/galmon

Observers:
* https://berthub.eu/articles/posts/galmon-project/

## Leaflet

* https://leafletjs.com

* https://github.com/Leaflet/Leaflet

Serving Leaflet images and javascript directly. Files from:

* https://unpkg.com/leaflet@1.8.0/dist/leaflet.js

* https://unpkg.com/leaflet@1.8.0/dist/leaflet.css


# Status
Works.


# License / Copyright
Source:

* https://spacecruft.org/spacecruft/leaflet-galmon

Unofficial project, not part of Leaflet or Galmon.
Upstream sources under their respective copyrights.

Copyright (C) 2022 Jeff Moe.

License: AGPLv3 or any later version.