mirror of
https://git.ianrenton.com/ian/spothole.git
synced 2026-09-24 08:14:32 +00:00
58 lines
3.4 KiB
Markdown
58 lines
3.4 KiB
Markdown
# 
|
|
|
|
Spothole is a utility to aggregate "spots" from amateur radio DX clusters and xOTA spotting sites, and provide an open
|
|
JSON API as well as a website to browse the data, and its own telnet server for integration with desktop loggers.
|
|
|
|
A "main" or example server runs at [https://spothole.app](https://spothole.app/) in case you'd like to try it out.
|
|
|
|
|
|
|
|
While there are several other web-based interfaces to DX clusters, and sites that aggregate spots from various outdoor
|
|
activity programmes for amateur radio, Spothole differentiates itself by supporting a large number of data sources, and
|
|
by being "API first" rather than just providing a web front-end. This allows other software to be built on top of it.
|
|
|
|
The API is deliberately well-defined with an OpenAPI specification and auto-generated API documentation. The API
|
|
delivers spots in a consistent format regardless of the data source, freeing developers from needing to know how each
|
|
individual data source presents its data.
|
|
|
|
Spothole itself is also open source, Public Domain licenced code that anyone can take and modify.
|
|
|
|
You can read more about Spothole on [the "Help" pages of the main server instance](https://spothole.app/help).
|
|
|
|
|
|
|
|
## Accessing the public version
|
|
|
|
You can access the public version's web interface at [https://spothole.app](https://spothole.app), and
|
|
see [https://spothole.app/apidocs](https://spothole.app/apidocs) for the API details.
|
|
|
|
You are more than welcome to use the data and the API that Spothole provides to power your own software, to run your own
|
|
Spothole server, or to modify it in any way. More details can be found
|
|
in [the "Help" pages of the main server instance](https://spothole.app/help).
|
|
|
|
|
|
|
|
## Thanks
|
|
|
|
[Spothole's "Thanks" page](https://spothole.app/help/thanks) contains the full details of the thanks I owe to the
|
|
various
|
|
programme teams, software library providers, bug fixers etc. The extra detail below contains the extra detail of
|
|
specific files in this repository which are not all my own work and may be subject to other licences.
|
|
|
|
The project contains GeoJSON files for CQ and ITU zones, in the `/datafiles/` directory. These are MIT-licenced and, to
|
|
my knowledge, created by HA8TKS for his CQ and ITU zone layers for Leaflet. `/datafiles` also contains a
|
|
`MUNICIPIOS.csv` file, from the "Nomenclátor Geográfico de Municipios y Entidades de Población" data set sourced from
|
|
[el Centro Nacional de Información Geográfica](https://centrodedescargas.cnig.es/CentroDescargas/home).
|
|
`didbase-stations.csv` and the TOTA file were created by me based on publicly available data from GIRO and from maps of
|
|
conference centres.
|
|
|
|
The project contains a set of flag icons generated using the "Noto Color Emoji" font on a Debian system, in the
|
|
`/static/img/flags/` directory.
|
|
|
|
The software uses a number of Python libraries as listed in `requirements.txt`, and a number of JavaScript libraries
|
|
which are self-hosted in the `/static/vendor/` directory. This project would not have been possible without these
|
|
libraries, so many thanks to their developers. These libraries are subject to their own licences and are not covered by
|
|
the overall licence declared in Spothole's `LICENSE` file.
|
|
|
|
Sound effects are CC0-licenced and sourced from [Pixabay](https://pixabay.com).
|