leaflet-galmon/README.md

137 lines
3.1 KiB
Markdown

# 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.