Prepare for misc.ianrenton.com going offline

.dockerignore

@@ -0,0 +1,7 @@
+/.venv
+__pycache__
+*.pyc
+/config.yml
+/cache/
+.git
+.gitignore

Dockerfile

@@ -0,0 +1,8 @@
+FROM python:3.13-slim
+
+WORKDIR /app
+COPY . .
+RUN pip install --no-cache-dir -r requirements.txt
+EXPOSE 8080
+
+CMD ["python3", "spothole.py"]

README.md

@@ -92,7 +92,7 @@ Various approaches exist to writing your own client, but in general:
 * Refer to the API docs. These are built on an OpenAPI definition file (`/static/apidocs/openapi.yml`), which you can
   automatically use to generate a client skeleton using various software.
 * Call the main "spots" or "alerts" API endpoints to get the data you want. For example, your app could call
-  `https://spothole.app/api/v2/spots` once every few minutes. Apply filters if necessary.
+  `https://spothole.app/api/v1/spots` once every few minutes. Apply filters if necessary.
 * Call the "options" API to get an idea of which bands, modes etc. the server knows about. You might want to do that
   first before calling the spots/alerts APIs, to allow you to populate your filters correctly.
 * Refer to the provided HTML/JS interface for a reference on different approaches. For example, the "alerts"/"upcoming"
@@ -105,12 +105,12 @@ once every two minutes, so if your client is interested in POTA data there's no
 than that.
 
 If you absolutely must be informed within seconds of a spot arriving in Spothole, please use the SSE endpoints instead,
-e.g. `https://spothole.app/api/v2/spots/stream`.
+e.g. `https://spothole.app/api/v1/spots/stream`.
 
 If you want to handle different types of spot or alert differently within your client, please consider making a single
 request to the Spothole API to retrieve all the data, then filtering on your side. For example, call
-`https://spothole.app/api/v2/spots?sig=POTA,SOTA` rather than making two separate calls to
-`https://spothole.app/api/v2/spots?sig=POTA` and `https://spothole.app/api/v2/spots?sig=SOTA`.
+`https://spothole.app/api/v1/spots?sig=POTA,SOTA` rather than making two separate calls to
+`https://spothole.app/api/v1/spots?sig=POTA` and `https://spothole.app/api/v1/spots?sig=SOTA`.
 
 Remember, here at Spothole Inc. we offer an industry-standard "five nines" uptime on our server, with our own unique
 twist: we don't tell you which side of the decimal point the nines start! (Translation: This is a hobby project.
@@ -172,6 +172,36 @@ countries. This is normal, don't panic!
 If you see some errors on startup, check your configuration, e.g. in case you have specified a port for the web server
 that is already in use by something else.
 
+### Running using Docker
+
+Spothole comes with a Docker configuration to make it easy to run it in a containerised environment. To set it up using
+Docker, the easiest way is to use a Docker Compose file. Create a new directory such as `/opt/docker/spothole` and
+create a `compose.yaml` file inside it with the following contents:
+
+```yaml
+services:
+  spothole:
+    container_name: spothole
+    build:
+      context: https://git.ianrenton.com/ian/spothole.git#main
+    restart: unless-stopped
+    ports:
+      - "8080:8080"
+    volumes:
+      - ./config.yml:/app/config.yml
+      - ./cache:/app/cache
+```
+
+You can replace `#main` with any other branch or tag reference, for example `#1.5` to pin the build to tagged version
+1.5.
+
+Save the file. You will still need to create a copy of `config-example.yml` and name it `config.yml`, though with the
+Docker setup nothing has actually been downloaded yet, so you will have to copy the example from the repository some
+other way, e.g. [from the repo in a web browser](https://git.ianrenton.com/ian/spothole/src/branch/main/config-example.yml).
+
+With that in place, run `docker compose up` and you should be good to go. To detach, press `d` or run the command with
+the `-d` flag.
+
 ### Multiple cluster nodes with different settings
 
 Dan, S50U has written in with his Spothole cluster settings. He is using a cluster node which provides RBN spots, and
@@ -354,7 +384,7 @@ server {
     }
     
     # SSE endpoints
-    location ~ ^/api/v2/(spots|alerts)/stream/? {
+    location ~ ^/api/v1/(spots|alerts)/stream/? {
         proxy_pass http://127.0.0.1:8080;
         
         # Remove buffering, remove caching, add suitable timeouts for SSE API calls
@@ -519,9 +549,6 @@ This project would not have been possible without these libraries, so many thank
 A number of third-party libraries are self-hosted in the `/static/vendor/` directory. These files are subject to
 their own licences and are not covered by the overall licence declared in the `LICENSE` file.
 
-A number of third-party libraries are self-hosted in the `/webassets/vendor/` directory. These files are subject to
-their own licences and are not covered by the overall licence declared in the `LICENSE` file.
-
 Particular thanks go to country-files.com for providing country lookup data for amateur radio, to K0SWE
 for [this JSON-formatted DXCC data](https://github.com/k0swe/dxcc-json/), and to the developers of `pyhamtools` for
 making it easy to use country-files.com data as well as QRZ.com and Clublog lookup.

alertproviders/alert_provider.py

@@ -8,10 +8,10 @@ from core.config import MAX_ALERT_AGE
 class AlertProvider:
     """Generic alert provider class. Subclasses of this query the individual APIs for alerts."""
 
-    def __init__(self, provider_config):
+    def __init__(self, name, provider_config):
         """Constructor"""
 
-        self.name = provider_config["name"]
+        self.name = name
         self.enabled = provider_config["enabled"]
         self.last_update_time = datetime.min.replace(tzinfo=pytz.UTC)
         self.status = "Not Started" if self.enabled else "Disabled"

alertproviders/bota.py

@@ -15,7 +15,7 @@ class BOTA(HTTPAlertProvider):
     ALERTS_URL = "https://www.beachesontheair.com/"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("BOTA", provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_alerts(self, http_response):
         new_alerts = []

alertproviders/http_alert_provider.py

@@ -14,8 +14,8 @@ class HTTPAlertProvider(AlertProvider):
     """Generic alert provider class for providers that request data via HTTP(S). Just for convenience to avoid code
     duplication. Subclasses of this query the individual APIs for data."""
 
-    def __init__(self, provider_config, url, poll_interval):
-        super().__init__(provider_config)
+    def __init__(self, name, provider_config, url, poll_interval):
+        super().__init__(name, provider_config)
         self._url = url
         self._poll_interval = poll_interval
         self._thread = None

alertproviders/ng3k.py

@@ -18,7 +18,7 @@ class NG3K(HTTPAlertProvider):
     AS_CALL_PATTERN = re.compile("as ([a-z0-9/]+)", re.IGNORECASE)
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("NG3K", provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_alerts(self, http_response):
         new_alerts = []

alertproviders/parksnpeaks.py

@@ -15,7 +15,7 @@ class ParksNPeaks(HTTPAlertProvider):
     ALERTS_URL = "https://parksnpeaks.org/api/ALERTS/"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("ParksNPeaks", provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_alerts(self, http_response):
         new_alerts = []

alertproviders/pota.py

@@ -14,7 +14,7 @@ class POTA(HTTPAlertProvider):
     ALERTS_URL = "https://api.pota.app/activation"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("POTA", provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_alerts(self, http_response):
         new_alerts = []

alertproviders/sota.py

@@ -14,7 +14,7 @@ class SOTA(HTTPAlertProvider):
     ALERTS_URL = "https://api-db2.sota.org.uk/api/alerts/365/all/all"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("SOTA", provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_alerts(self, http_response):
         new_alerts = []

alertproviders/wota.py

@@ -18,7 +18,7 @@ class WOTA(HTTPAlertProvider):
     RSS_DATE_TIME_FORMAT = "%a, %d %b %Y %H:%M:%S %z"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("WOTA", provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_alerts(self, http_response):
         new_alerts = []

alertproviders/wwff.py

@@ -14,7 +14,7 @@ class WWFF(HTTPAlertProvider):
     ALERTS_URL = "https://spots.wwff.co/static/agendas.json"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("WWFF", provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_alerts(self, http_response):
         new_alerts = []

config-example.yml

@@ -19,66 +19,55 @@ base-url: "http://localhost:8080"
 
 # Spot providers to use. This is an example set, tailor it to your liking by commenting and uncommenting.
 # RBN and APRS-IS are supported but have such a high data rate, you probably don't want them enabled.
-# Each provider needs a class, a name, and an enabled/disabled state. Some require more config such as hostnames/IP
+# Each provider needs a class and an enabled/disabled state. Some require more config such as hostnames/IP
 # addresses and ports. You can duplicate them if you like, e.g. to support several DX clusters. RBN uses two ports, 7000
 # for CW/RTTY and 7001 for FT8, so if you want both, you need two entries, as shown below.
 # Feel free to write your own provider classes! There are details in the README.
 spot-providers:
   - class: "POTA"
-    name: "POTA"
     enabled: true
 
   - class: "SOTA"
-    name: "SOTA"
     enabled: true
 
   - class: "WWFF"
-    name: "WWFF"
     enabled: true
 
   - class: "WWBOTA"
-    name: "WWBOTA"
     enabled: true
 
   - class: "GMA"
-    name: "GMA"
     enabled: true
     # GMA requires an API key to fetch spots. After creating an account on cqgma.org, email support and request one.
     api-key: ""
 
   - class: "HEMA"
-    name: "HEMA"
     enabled: true
 
   - class: "ParksNPeaks"
-    name: "ParksNPeaks"
     enabled: true
 
   - class: "ZLOTA"
-    name: "ZLOTA"
     enabled: true
 
   - class: "WOTA"
-    name: "WOTA"
     enabled: true
 
   - class: "LLOTA"
-    name: "LLOTA"
     enabled: true
 
   - class: "Towers"
-    name: "Towers"
     enabled: true
 
   - class: "Tiles"
-    name: "Tiles"
     enabled: true
 
   - class: "APRSIS"
-    name: "APRS-IS"
     enabled: false
 
   - class: "DXCluster"
+    # Clusters have a "name" property in case you want to say which cluster node the data is from, or connect to
+    # several clusters and name them separately.
     name: "HRD Cluster"
     enabled: true
     host: "hrd.wa9pie.net"
@@ -99,18 +88,12 @@ spot-providers:
     enabled: false
     host: "w3lpl.net"
     port: 7373
-    # Prompt the cluster node gives when asking for a callsign to log in. Varies between cluster node software.
     login_prompt: "Please enter your call:"
-    # Callsign Spothole will use to log into this cluster. Ensure the SSID (e.g. -99) is different to any personal
-    # connection you might make to this cluster node.
     login_callsign: "N0CALL-99"
-    # Whether to allow RBN spots that come via this cluster. If you don't want RBN spots or you are making a separate
-    # connection to RBN directly, leave this as False. If you want RBN spots from this cluster, set this to True. (Make
-    # sure you aren't also separately connecting to RBN directly, otherwise you may get duplicate spots.) Note that not
-    # all clusters sent RBN spots anyway.
     allow_rbn_spots: false
 
   - class: "RBN"
+  - # RBN sources have a "name" property in case you want to differentiate between the CW/RTTY and FT8 sources.
     name: "RBN CW/RTTY"
     enabled: false
     port: 7000
@@ -127,11 +110,12 @@ spot-providers:
     enabled-by-default-in-web-ui: false
 
   - class: "UKPacketNet"
-    name: "UK Packet Radio Net"
     enabled: false
     enabled-by-default-in-web-ui: false
 
   - class: "XOTA"
+    # xOTA sources have a "name" property so you can define what programme it is for, since xOTA is generic software
+    # for running "something-on-the-air" programmes.
     name: "39C3 TOTA"
     enabled: false
     url: "wss://39c3.totawatch.de/api/spot/live"
@@ -152,51 +136,40 @@ spot-providers:
 # Alert providers to use. Same setup as the spot providers list above.
 alert-providers:
   - class: "POTA"
-    name: "POTA"
     enabled: true
 
   - class: "SOTA"
-    name: "SOTA"
     enabled: true
 
   - class: "WWFF"
-    name: "WWFF"
     enabled: true
 
   - class: "ParksNPeaks"
-    name: "ParksNPeaks"
     enabled: true
 
   - class: "WOTA"
-    name: "WOTA"
     enabled: true
 
   - class: "BOTA"
-    name: "BOTA"
     enabled: true
 
   - class: "NG3K"
-    name: "NG3K"
     enabled: true
 
 
 # Solar condition providers to use. These poll external APIs for solar propagation data (SFI, A/K indices, band
-# conditions, etc.) and make it available via the /api/v2/solar endpoint.
+# conditions, etc.) and make it available via the /api/v1/solar endpoint.
 solar-condition-providers:
   - class: "HamQSL"
-    name: "HamQSL"
     enabled: true
 
   - class: "NOAA3dayForecast"
-    name: "NOAA 3-day Forecast"
     enabled: true
 
   - class: "GIROIonosonde"
-    name: "GIRO Ionosonde Data"
     enabled: true
 
   - class: "KC2GProp"
-    name: "KC2G Propagation Data"
     enabled: true
 
 # Maximum time to keep spots and alerts in the system before deleting them. By default, one hour for spots and one week
@@ -211,20 +184,6 @@ clublog-api-key: ""
 # Allow submitting spots to the Spothole API?
 allow-spotting: true
 
-# Allow upstream submission of spots to external providers (POTA, SOTA, etc.) via the API?
-# Requires allow-spotting to also be true. Set to false to only accept spots into the local
-# Spothole database, without forwarding them to any external service.
-allow-upstream-spotting: true
-
-# Google reCAPTCHA v2 keys for CAPTCHA protection on upstream spot submission. Both keys must be set to enable CAPTCHA.
-# Leave both empty to disable CAPTCHA (e.g. for a private/trusted server) or if allow-spotting is false, in which case
-# they will do nothing. Note that with CAPTCHA enabled, this will prevent third-party clients submitting spots through
-# Spothole unless the clients are web-based, use the same site key, have their domains enabled in your reCAPTCHA config,
-# and of course their user solves the CAPTCHA.
-# You can sign up for reCAPTCHA at https://www.google.com/recaptcha/
-recaptcha-site-key: ""
-recaptcha-secret-key: ""
-
 # Log web requests? Useful to see what your users are requesting in terms of pages and API endpoints, but will fill up
 # your log quickly on a popular server.
 log-web-requests: false

core/config.py

@@ -14,17 +14,14 @@ with open("config.yml") as f:
     config = yaml.safe_load(f)
 logging.info("Loaded config.")
 
-BASE_URL = config.get("base-url", "http://localhost:8080")
-MAX_SPOT_AGE = config.get("max-spot-age-sec", 3600)
-MAX_ALERT_AGE = config.get("max-alert-age-sec", 604800)
-SERVER_OWNER_CALLSIGN = config.get("server-owner-callsign", "N0CALL")
-WEB_SERVER_PORT = config.get("web-server-port", 8080)
-ALLOW_SPOTTING = config.get("allow-spotting", True)
-ALLOW_UPSTREAM_SPOTTING = config.get("allow-upstream-spotting", True)
-WEB_UI_OPTIONS = config.get("web-ui-options", {})
+BASE_URL = config["base-url"]
+MAX_SPOT_AGE = config["max-spot-age-sec"]
+MAX_ALERT_AGE = config["max-alert-age-sec"]
+SERVER_OWNER_CALLSIGN = config["server-owner-callsign"]
+WEB_SERVER_PORT = config["web-server-port"]
+ALLOW_SPOTTING = config["allow-spotting"]
+WEB_UI_OPTIONS = config["web-ui-options"]
 API_ONLY_MODE = config.get("api-only-mode", False)
-RECAPTCHA_SECRET_KEY = config.get("recaptcha-secret-key", "")
-RECAPTCHA_SITE_KEY = config.get("recaptcha-site-key", "")
 LOG_LEVEL = config.get("log-level", "INFO")
 LOG_WEB_REQUESTS = config.get("log-web-requests", False)
 
@@ -33,9 +30,6 @@ LOG_WEB_REQUESTS = config.get("log-web-requests", False)
 WEB_UI_OPTIONS["spot-providers-enabled-by-default"] = [p["name"] for p in config["spot-providers"] if p["enabled"] and (
         "enabled-by-default-in-web-ui" not in p or p["enabled-by-default-in-web-ui"])]
 # If spotting to this server is enabled, "API" is another valid spot source even though it does not come from
-# one of our proviers. We set that to also be enabled by default. We can also include the reCaptcha site key so the UI
-# can access it.
+# one of our proviers. We set that to also be enabled by default.
 if ALLOW_SPOTTING:
     WEB_UI_OPTIONS["spot-providers-enabled-by-default"].append("API")
-    WEB_UI_OPTIONS["recaptcha-site-key"] = RECAPTCHA_SITE_KEY
-WEB_UI_OPTIONS["allow-upstream-spotting"] = ALLOW_SPOTTING and ALLOW_UPSTREAM_SPOTTING

core/constants.py

@@ -3,7 +3,7 @@ from data.band import Band
 from data.sig import SIG
 
 # General software
-SOFTWARE_VERSION = "1.4-pre"
+SOFTWARE_VERSION = "1.4"
 
 # HTTP headers used for spot providers that use HTTP
 HTTP_HEADERS = {"User-Agent": "Spothole v" + SOFTWARE_VERSION + " (operated by " + SERVER_OWNER_CALLSIGN + ")"}
@@ -11,7 +11,7 @@ HAMQTH_PRG = ("Spothole v" + SOFTWARE_VERSION + " operated by " + SERVER_OWNER_C
 
 # Special Interest Groups
 SIGS = [
-    SIG(name="POTA", comment_names=["POTA"], description="Parks on the Air", ref_regex=r"[A-Z]{2}\-\d{4,5}|K\-TEST"),
+    SIG(name="POTA", comment_names=["POTA"], description="Parks on the Air", ref_regex=r"[A-Z]{2}\-\d{4,5}"),
     SIG(name="SOTA", comment_names=["SOTA"], description="Summits on the Air", ref_regex=r"[A-Z0-9]{1,3}\/[A-Z]{2}\-\d{3}"),
     SIG(name="WWFF", comment_names=["WWFF"], description="World Wide Flora & Fauna", ref_regex=r"[A-Z0-9]{1,3}FF\-\d{4}"),
     SIG(name="GMA", comment_names=["GMA"], description="Global Mountain Activity", ref_regex=r"[A-Z0-9]{1,3}\/[A-Z]{2}\-\d{3}"),
@@ -38,12 +38,10 @@ SIGS = [
 
 # Modes. Note "DIGI" and "DIGITAL" are also supported but are normalised into "DATA".
 CW_MODES = ["CW"]
-PHONE_MODES = ["PHONE", "SSB", "USB", "LSB", "AM", "FM", "DV", "DMR", "DSTAR", "C4FM", "FUSION", "M17"]
+PHONE_MODES = ["PHONE", "SSB", "USB", "LSB", "AM", "FM", "DV", "DMR", "DSTAR", "C4FM", "M17"]
 DATA_MODES = ["DATA", "FT8", "FT4", "RTTY", "SSTV", "JS8", "HELL", "PSK", "OLIVIA", "PKT", "MSK144"]
 ALL_MODES = CW_MODES + PHONE_MODES + DATA_MODES
 MODE_TYPES = ["CW", "PHONE", "DATA"]
-SSB_SUB_MODES = ["USB", "LSB"]
-DV_SUB_MODES = ["DMR", "DSTAR", "C4FM", "FUSION", "M17"]
 
 # Mode aliases. Sometimes we get spots with a mode described in a different way that is effectively the same as a mode
 # we already know, or we want to normalise things for consistency. The lookup table for this is here. Incoming spots

data/lookup_credentials.py

@@ -12,15 +12,15 @@ class LookupCredentials:
     hamqth_session_id: str = ""  # alternative to username/password
 
 
-def extract_credentials(headers):
-    """Build a LookupCredentials from HTTP request headers; returns None if no usable credentials are present."""
+def extract_credentials(query_params):
+    """Build a LookupCredentials from HTTP query params; returns None if no usable credentials are present."""
     creds = LookupCredentials(
-        qrz_username=headers.get("X-QRZ-Username", ""),
-        qrz_password=headers.get("X-QRZ-Password", ""),
-        qrz_session_key=headers.get("X-QRZ-Session-Key", ""),
-        hamqth_username=headers.get("X-HamQTH-Username", ""),
-        hamqth_password=headers.get("X-HamQTH-Password", ""),
-        hamqth_session_id=headers.get("X-HamQTH-Session-ID", ""),
+        qrz_username=query_params.get("qrz_username", ""),
+        qrz_password=query_params.get("qrz_password", ""),
+        qrz_session_key=query_params.get("qrz_session_key", ""),
+        hamqth_username=query_params.get("hamqth_username", ""),
+        hamqth_password=query_params.get("hamqth_password", ""),
+        hamqth_session_id=query_params.get("hamqth_session_id", ""),
     )
     has_qrz = creds.qrz_session_key or (creds.qrz_username and creds.qrz_password)
     has_hamqth = creds.hamqth_session_id or (creds.hamqth_username and creds.hamqth_password)

server/handlers/api/addspot.py

@@ -1,40 +1,33 @@
 import logging
 import re
-import threading
 from datetime import datetime
 from typing import Any
 
 import pytz
-import requests
 import tornado
 from tornado import httputil
 from tornado.web import Application
 
-from core.config import ALLOW_SPOTTING, ALLOW_UPSTREAM_SPOTTING, MAX_SPOT_AGE, RECAPTCHA_SECRET_KEY
+from core.config import ALLOW_SPOTTING, MAX_SPOT_AGE
 from core.constants import UNKNOWN_BAND
 from core.lookup_helper import infer_band_from_freq
 from core.prometheus_metrics_handler import api_requests_counter
 from core.sig_utils import get_ref_regex_for_sig
 from core.utils import safe_json_dumps
 from data.spot import Spot
-from spotproviders.spot_provider import SpotProvider
-
-RECAPTCHA_VERIFY_URL = "https://www.google.com/recaptcha/api/siteverify"
 
 
 class APISpotHandler(tornado.web.RequestHandler):
-    """API request handler for /api/v2/spot (POST)"""
+    """API request handler for /api/v1/spot (POST)"""
 
     def __init__(self, application: "Application", request: httputil.HTTPServerRequest, **kwargs: Any):
         self._spots = None
         self._web_server_metrics = None
-        self._spot_providers = None
         super().__init__(application, request, **kwargs)
 
-    def initialize(self, spots, web_server_metrics, spot_providers=None):
+    def initialize(self, spots, web_server_metrics):
         self._spots = spots
         self._web_server_metrics = web_server_metrics
-        self._spot_providers = spot_providers or []
 
     def post(self):
         try:
@@ -69,38 +62,9 @@ class APISpotHandler(tornado.web.RequestHandler):
                 self.set_header("Content-Type", "application/json")
                 return
 
-            # Read in the request body as JSON
-            json_body = tornado.escape.json_decode(post_data)
-
-            # Extract the "spot" and "handling" sub-objects from the request body
-            spot_data = json_body.get("spot", {})
-            handling = json_body.get("handling", {})
-
-            # Extract individual parameters that say how this spot should be handled by the server
-            submit_upstream = handling.get("submit_upstream", False)
-            upstream_provider_name = handling.get("upstream_provider", None)
-            upstream_credentials = handling.get("upstream_credentials", {})
-            captcha_token = handling.get("captcha_token", None)
-
-            # Verify CAPTCHA if required
-            if RECAPTCHA_SECRET_KEY:
-                if not captcha_token:
-                    self.set_status(422)
-                    self.write(json.dumps("Error - CAPTCHA token is required for spot submission.",
-                                          default=serialize_everything))
-                    self.set_header("Cache-Control", "no-store")
-                    self.set_header("Content-Type", "application/json")
-                    return
-                if not self._verify_recaptcha(captcha_token):
-                    self.set_status(422)
-                    self.write(json.dumps("Error - CAPTCHA verification failed.",
-                                          default=serialize_everything))
-                    self.set_header("Cache-Control", "no-store")
-                    self.set_header("Content-Type", "application/json")
-                    return
-
-            # Convert spot field to a Spot object
-            spot = Spot(**spot_data)
+            # Read in the request body as JSON then convert to a Spot object
+            json_spot = tornado.escape.json_decode(post_data)
+            spot = Spot(**json_spot)
 
             # Reject if no timestamp, frequency, dx_call or de_call
             if not spot.time or not spot.dx_call or not spot.freq or not spot.de_call:
@@ -152,76 +116,11 @@ class APISpotHandler(tornado.web.RequestHandler):
                 self.set_header("Content-Type", "application/json")
                 return
 
-            # Reject upstream submission if not permitted
-            if submit_upstream and not ALLOW_UPSTREAM_SPOTTING:
-                self.set_status(403)
-                self.write(json.dumps("Error - this server does not allow upstream spot submission.",
-                                      default=serialize_everything))
-                self.set_header("Cache-Control", "no-store")
-                self.set_header("Content-Type", "application/json")
-                return
-
-            # Validate upstream submission requirements
-            if submit_upstream and upstream_provider_name:
-                if not spot.sig:
-                    self.set_status(422)
-                    self.write(json.dumps("Error - a SIG must be selected to submit upstream.",
-                                          default=serialize_everything))
-                    self.set_header("Cache-Control", "no-store")
-                    self.set_header("Content-Type", "application/json")
-                    return
-                if not spot.sig_refs and upstream_provider_name != "Tiles":
-                    self.set_status(422)
-                    self.write(json.dumps("Error - a SIG reference is required to submit upstream.",
-                                          default=serialize_everything))
-                    self.set_header("Cache-Control", "no-store")
-                    self.set_header("Content-Type", "application/json")
-                    return
-                if not spot.dx_grid and upstream_provider_name == "Tiles":
-                    self.set_status(422)
-                    self.write(json.dumps("Error - a grid reference is required to submit upstream to Tiles on the Air.",
-                                          default=serialize_everything))
-                    self.set_header("Cache-Control", "no-store")
-                    self.set_header("Content-Type", "application/json")
-                    return
-                if not spot.mode and upstream_provider_name == "Tiles":
-                    self.set_status(422)
-                    self.write(json.dumps("Error - a mode is required to submit upstream to Tiles on the Air.",
-                                          default=serialize_everything))
-                    self.set_header("Cache-Control", "no-store")
-                    self.set_header("Content-Type", "application/json")
-                    return
-
-            # Submit upstream if requested
-            upstream_warning = None
-            if submit_upstream and upstream_provider_name:
-                provider = self._find_provider(upstream_provider_name, spot.sig)
-                if provider:
-                    try:
-                        # Submit spot to the upstream provider
-                        provider.submit_spot(spot, upstream_credentials)
-                        # Trigger a re-poll after 1 second so the spot appears quickly
-                        threading.Timer(1.0, provider.force_poll).start()
-                    except NotImplementedError as e:
-                        upstream_warning = str(e)
-                    except Exception as e:
-                        logging.warning("Failed to submit spot upstream to " + upstream_provider_name + ": " + str(e))
-                        upstream_warning = "Spot was saved locally but upstream submission to " + upstream_provider_name + " failed: " + str(
-                            e)
-                else:
-                    upstream_warning = "No enabled provider named '" + upstream_provider_name + "' supports upstream submission for " + spot.sig + " spots."
-
-            # If we successfully submitted the spot upstream, don't add it direct to Spothole, otherwise it will be a
-            # duplicate with what immediately comes back from the API. But if we weren't asked to send it upstream, or
-            # we were but it failed, we should still add it to our database anyway.
-            if not submit_upstream or upstream_warning:
+            # infer missing data, and add it to our database.
+            spot.source = "API"
             spot.infer_missing()
             self._spots.add(spot.id, spot, expire=MAX_SPOT_AGE)
 
-            if upstream_warning:
-                self.write(json.dumps("Warning - " + upstream_warning, default=serialize_everything))
-                self.set_status(201)
-            else:
             self.write(safe_json_dumps("OK"))
             self.set_status(201)
             self.set_header("Cache-Control", "no-store")
@@ -233,24 +132,3 @@ class APISpotHandler(tornado.web.RequestHandler):
             self.set_status(500)
             self.set_header("Cache-Control", "no-store")
             self.set_header("Content-Type", "application/json")
-
-    def _find_provider(self, provider_name, sig) -> SpotProvider | None:
-        """Find an enabled provider by name that can submit spots for the given SIG."""
-
-        for p in self._spot_providers:
-            if p.enabled and p.name == provider_name and p.can_submit_spot(sig):
-                return p
-        return None
-
-    @staticmethod
-    def _verify_recaptcha(token):
-        """Verify a Google reCAPTCHA v2 token. Returns True if valid."""
-
-        try:
-            response = requests.post(RECAPTCHA_VERIFY_URL,
-                                     data={"secret": RECAPTCHA_SECRET_KEY, "response": token},
-                                     timeout=(5, 10))
-            return response.ok and response.json().get("success", False)
-        except Exception as e:
-            logging.warning("reCAPTCHA verification request failed: " + str(e))
-            return False

server/handlers/api/alerts.py

@@ -19,7 +19,7 @@ SSE_HANDLER_QUEUE_CHECK_INTERVAL = 5000
 
 
 class APIAlertsHandler(tornado.web.RequestHandler):
-    """API request handler for /api/v2/alerts"""
+    """API request handler for /api/v1/alerts"""
 
     def __init__(self, application: "Application", request: httputil.HTTPServerRequest, **kwargs: Any):
         self._alerts = None
@@ -52,7 +52,7 @@ class APIAlertsHandler(tornado.web.RequestHandler):
             query_params = {k: v[0].decode("utf-8") for k, v in self.request.arguments.items()}
 
             # Fetch all alerts matching the query, then optionally enrich with online data
-            credentials = extract_credentials(self.request.headers)
+            credentials = extract_credentials(query_params)
             data = get_alert_list_with_filters(self._alerts, query_params)
             if credentials:
                 data = self._enrich(data, credentials)
@@ -70,7 +70,7 @@ class APIAlertsHandler(tornado.web.RequestHandler):
 
 
 class APIAlertsStreamHandler(tornado_eventsource.handler.EventSourceHandler):
-    """API request handler for /api/v2/alerts/stream"""
+    """API request handler for /api/v1/alerts/stream"""
 
     def __init__(self, application, request, **kwargs: Any):
         self._sse_alert_queues = None
@@ -102,7 +102,7 @@ class APIAlertsStreamHandler(tornado_eventsource.handler.EventSourceHandler):
             # request.arguments contains lists for each param key because technically the client can supply multiple,
             # reduce that to just the first entry, and convert bytes to string
             self._query_params = {k: v[0].decode("utf-8") for k, v in self.request.arguments.items()}
-            self._credentials = extract_credentials(self.request.headers)
+            self._credentials = extract_credentials(self._query_params)
 
             # Create a alert queue and add it to the web server's list. The web server will fill this when alerts arrive
             self._alert_queue = Queue(maxsize=SSE_HANDLER_MAX_QUEUE_SIZE)

server/handlers/api/dxstats.py

@@ -19,7 +19,7 @@ BANDS_SET = frozenset(BANDS)
 
 
 class APIDxStatsHandler(tornado.web.RequestHandler):
-    """API request handler for /api/v2/dxstats"""
+    """API request handler for /api/v1/dxstats"""
 
     def __init__(self, application: "Application", request: httputil.HTTPServerRequest, **kwargs: Any):
         self._spots = None

server/handlers/api/lookups.py

@@ -19,7 +19,7 @@ from data.spot import Spot
 
 
 class APILookupCallHandler(tornado.web.RequestHandler):
-    """API request handler for /api/v2/lookup/call"""
+    """API request handler for /api/v1/lookup/call"""
 
     def __init__(self, application: "Application", request: httputil.HTTPServerRequest, **kwargs: Any):
         self._web_server_metrics = None
@@ -46,7 +46,7 @@ class APILookupCallHandler(tornado.web.RequestHandler):
                 if re.match(r"^[A-Z0-9/\-]*$", call):
                     # Take the callsign, make a "fake spot" so we can run infer_missing() on it, then repack the
                     # resulting data in the correct way for the API response.
-                    credentials = extract_credentials(self.request.headers)
+                    credentials = extract_credentials(query_params)
                     fake_spot = Spot(dx_call=call)
                     fake_spot.infer_missing(credentials)
                     data = {
@@ -83,7 +83,7 @@ class APILookupCallHandler(tornado.web.RequestHandler):
 
 
 class APILookupSIGRefHandler(tornado.web.RequestHandler):
-    """API request handler for /api/v2/lookup/sigref"""
+    """API request handler for /api/v1/lookup/sigref"""
 
     def __init__(self, application: "Application", request: httputil.HTTPServerRequest, **kwargs: Any):
         self._web_server_metrics = None
@@ -135,7 +135,7 @@ class APILookupSIGRefHandler(tornado.web.RequestHandler):
 
 
 class APILookupGridHandler(tornado.web.RequestHandler):
-    """API request handler for /api/v2/lookup/grid"""
+    """API request handler for /api/v1/lookup/grid"""
 
     def __init__(self, application: "Application", request: httputil.HTTPServerRequest, **kwargs: Any):
         self._web_server_metrics = None

server/handlers/api/options.py

@@ -14,18 +14,16 @@ from core.utils import safe_json_dumps
 
 
 class APIOptionsHandler(tornado.web.RequestHandler):
-    """API request handler for /api/v2/options"""
+    """API request handler for /api/v1/options"""
 
     def __init__(self, application: "Application", request: httputil.HTTPServerRequest, **kwargs: Any):
         self._status_data = None
         self._web_server_metrics = None
-        self._spot_providers = None
         super().__init__(application, request, **kwargs)
 
-    def initialize(self, status_data, web_server_metrics, spot_providers=None):
+    def initialize(self, status_data, web_server_metrics):
         self._status_data = status_data
         self._web_server_metrics = web_server_metrics
-        self._spot_providers = spot_providers or []
 
     def get(self):
         try:
@@ -35,37 +33,23 @@ class APIOptionsHandler(tornado.web.RequestHandler):
             self._web_server_metrics["status"] = "OK"
             api_requests_counter.inc()
 
-            # Build a map of SIG name -> list of provider names that can submit spots for that SIG
-        spot_submit_providers = {}
-        for provider in self._spot_providers:
-            if not provider.enabled:
-                continue
-            for sig in SIGS:
-                    if provider.can_submit_spot(sig.name):
-                    spot_submit_providers.setdefault(sig.name, []).append(provider.name)
-
-        # Spot/alert sources are filtered for only ones that are enabled in config, no point letting the user toggle
-        # things that aren't even available.
-        spot_sources: list = list(
-            map(lambda p: p["name"], filter(lambda p: p["enabled"], self._status_data["spot_providers"])))
-        alert_sources = list(
-            map(lambda p: p["name"], filter(lambda p: p["enabled"], self._status_data["alert_providers"])))
-        # If spotting to this server is enabled, "API" is another valid spot source even though it does not come from
-        # one of our providers.
-            if ALLOW_SPOTTING:
-                spot_sources.append("API")
-
             options = {"bands": BANDS,
                        "modes": ALL_MODES,
                        "mode_types": MODE_TYPES,
                        "sigs": SIGS,
-                   "spot_sources": spot_sources,
-                   "alert_sources": alert_sources,
+                       # Spot/alert sources are filtered for only ones that are enabled in config, no point letting the user toggle things that aren't even available.
+                       "spot_sources": list(
+                           map(lambda p: p["name"], filter(lambda p: p["enabled"], self._status_data["spot_providers"]))),
+                       "alert_sources": list(
+                           map(lambda p: p["name"], filter(lambda p: p["enabled"], self._status_data["alert_providers"]))),
                        "continents": CONTINENTS,
                        "propagation_modes": list(PROPAGATION_MODES.values()),
                        "max_spot_age": MAX_SPOT_AGE,
-                   "spot_allowed": ALLOW_SPOTTING,
-                   "spot_submit_providers": spot_submit_providers}
+                       "spot_allowed": ALLOW_SPOTTING}
+            # If spotting to this server is enabled, "API" is another valid spot source even though it does not come from
+            # one of our proviers.
+            if ALLOW_SPOTTING:
+                options["spot_sources"].append("API")
 
             self.write(safe_json_dumps(options))
             self.set_status(200)

server/handlers/api/solar_conditions.py

@@ -12,7 +12,7 @@ from core.utils import safe_json_dumps
 
 
 class APISolarConditionsHandler(tornado.web.RequestHandler):
-    """API request handler for /api/v2/solar"""
+    """API request handler for /api/v1/solar"""
 
     def __init__(self, application: "Application", request: httputil.HTTPServerRequest, **kwargs: Any):
         self._solar_conditions = None

server/handlers/api/spots.py

@@ -19,7 +19,7 @@ SSE_HANDLER_QUEUE_CHECK_INTERVAL = 5000
 
 
 class APISpotsHandler(tornado.web.RequestHandler):
-    """API request handler for /api/v2/spots"""
+    """API request handler for /api/v1/spots"""
 
     def __init__(self, application: "Application", request: httputil.HTTPServerRequest, **kwargs: Any):
         self._spots = None
@@ -52,7 +52,7 @@ class APISpotsHandler(tornado.web.RequestHandler):
             query_params = {k: v[0].decode("utf-8") for k, v in self.request.arguments.items()}
 
             # Fetch all spots matching the query, then optionally enrich with online data
-            credentials = extract_credentials(self.request.headers)
+            credentials = extract_credentials(query_params)
             data = get_spot_list_with_filters(self._spots, query_params)
             if credentials:
                 data = self._enrich(data, credentials)
@@ -70,7 +70,7 @@ class APISpotsHandler(tornado.web.RequestHandler):
 
 
 class APISpotsStreamHandler(tornado_eventsource.handler.EventSourceHandler):
-    """API request handler for /api/v2/spots/stream"""
+    """API request handler for /api/v1/spots/stream"""
 
     def __init__(self, application, request, **kwargs: Any):
         self._sse_spot_queues = None
@@ -104,7 +104,7 @@ class APISpotsStreamHandler(tornado_eventsource.handler.EventSourceHandler):
             # request.arguments contains lists for each param key because technically the client can supply multiple,
             # reduce that to just the first entry, and convert bytes to string
             self._query_params = {k: v[0].decode("utf-8") for k, v in self.request.arguments.items()}
-            self._credentials = extract_credentials(self.request.headers)
+            self._credentials = extract_credentials(self._query_params)
 
             # Create a spot queue and add it to the web server's list. The web server will fill this when spots arrive
             self._spot_queue = Queue(maxsize=SSE_HANDLER_MAX_QUEUE_SIZE)

server/handlers/api/status.py

@@ -12,7 +12,7 @@ from core.utils import safe_json_dumps
 
 
 class APIStatusHandler(tornado.web.RequestHandler):
-    """API request handler for /api/v2/status"""
+    """API request handler for /api/v1/status"""
 
     def __init__(self, application: "Application", request: httputil.HTTPServerRequest, **kwargs: Any):
         self._status_data = None

server/handlers/api/v1_compatability.py

@@ -1,31 +0,0 @@
-import json
-
-import tornado
-
-from core.utils import serialize_everything
-
-
-class V1GoneHandler(tornado.web.RequestHandler):
-    """Returns 410 Gone with a message for any endpoints in the old API that have breaking changes in the new one or
-    have been retired."""
-
-    def post(self):
-        self.set_status(410)
-        self.write(json.dumps(
-            "This API endpoint has a breaking change or has been removed in the current version of the Spothole API. Please see /apidocs for details of the current API version and the endpoints available.",
-            default=serialize_everything
-        ))
-        self.set_header("Cache-Control", "no-store")
-        self.set_header("Content-Type", "application/json")
-
-
-class V1RedirectHandler(tornado.web.RequestHandler):
-    """Returns 308 Permanent Redirect from any path in the old API to the new one, where there were no breaking changes."""
-
-    def get(self, path):
-        new_url = "/api/v2/" + path
-        if self.request.query:
-            new_url += "?" + self.request.query
-        self.set_status(308)
-        self.set_header("Location", new_url)
-        self.finish()

server/webserver.py

@@ -8,7 +8,6 @@ from tornado.web import StaticFileHandler
 from core.config import ALLOW_SPOTTING, WEB_SERVER_PORT, API_ONLY_MODE, LOG_WEB_REQUESTS, BASE_URL
 from core.utils import empty_queue
 from server.handlers.api.addspot import APISpotHandler
-from server.handlers.api.v1_compatability import V1RedirectHandler, V1GoneHandler
 from server.handlers.api.alerts import APIAlertsHandler, APIAlertsStreamHandler
 from server.handlers.api.dxstats import APIDxStatsHandler
 from server.handlers.api.lookups import APILookupCallHandler, APILookupSIGRefHandler, APILookupGridHandler
@@ -26,7 +25,7 @@ _HERE = os.path.dirname(__file__ or "")
 class WebServer:
     """Provides the public-facing web server."""
 
-    def __init__(self, spots, alerts, solar_conditions, status_data, spot_providers=None):
+    def __init__(self, spots, alerts, solar_conditions, status_data):
         """Constructor"""
 
         self._spots = spots
@@ -35,7 +34,6 @@ class WebServer:
         self._sse_spot_queues = []
         self._sse_alert_queues = []
         self._status_data = status_data
-        self._spot_providers = spot_providers or []
         self._port = WEB_SERVER_PORT
         self._api_only_mode = API_ONLY_MODE
         self._shutdown_event = asyncio.Event()
@@ -66,29 +64,20 @@ class WebServer:
 
         # API endpoints are always enabled
         api_routes = [
-            (r"/api/v2/spots", APISpotsHandler, {"spots": self._spots, **handler_opts}),
-            (r"/api/v2/alerts", APIAlertsHandler, {"alerts": self._alerts, **handler_opts}),
-            (r"/api/v2/spots/stream", APISpotsStreamHandler,
+            (r"/api/v1/spots", APISpotsHandler, {"spots": self._spots, **handler_opts}),
+            (r"/api/v1/alerts", APIAlertsHandler, {"alerts": self._alerts, **handler_opts}),
+            (r"/api/v1/spots/stream", APISpotsStreamHandler,
              {"sse_spot_queues": self._sse_spot_queues, **handler_opts}),
-            (r"/api/v2/alerts/stream", APIAlertsStreamHandler,
+            (r"/api/v1/alerts/stream", APIAlertsStreamHandler,
              {"sse_alert_queues": self._sse_alert_queues, **handler_opts}),
-            (r"/api/v2/solar", APISolarConditionsHandler, {"solar_conditions": self._solar_conditions, **handler_opts}),
-            (r"/api/v2/dxstats", APIDxStatsHandler, {"spots": self._spots, **handler_opts}),
-            (r"/api/v2/options", APIOptionsHandler,
-             {"status_data": self._status_data, "spot_providers": self._spot_providers, **handler_opts}),
-            (r"/api/v2/status", APIStatusHandler, {"status_data": self._status_data, **handler_opts}),
-            (r"/api/v2/lookup/call", APILookupCallHandler, {**handler_opts}),
-            (r"/api/v2/lookup/sigref", APILookupSIGRefHandler, {**handler_opts}),
-            (r"/api/v2/lookup/grid", APILookupGridHandler, {**handler_opts}),
-            (r"/api/v2/spot", APISpotHandler,
-             {"spots": self._spots, "spot_providers": self._spot_providers, **handler_opts}),
-        ]
-
-        # v1 API redirects. Most v1 enpoints are unchanged in v2, and get an HTTP 308 redirect to the v2 API. The ones
-        # that have the actual breaking changes get a bespoke handler.
-        v1_compat_routes = [
-            (r"/api/v1/spot", V1GoneHandler),
-            (r"/api/v1/(.*)", V1RedirectHandler),
+            (r"/api/v1/solar", APISolarConditionsHandler, {"solar_conditions": self._solar_conditions, **handler_opts}),
+            (r"/api/v1/dxstats", APIDxStatsHandler, {"spots": self._spots, **handler_opts}),
+            (r"/api/v1/options", APIOptionsHandler, {"status_data": self._status_data, **handler_opts}),
+            (r"/api/v1/status", APIStatusHandler, {"status_data": self._status_data, **handler_opts}),
+            (r"/api/v1/lookup/call", APILookupCallHandler, {**handler_opts}),
+            (r"/api/v1/lookup/sigref", APILookupSIGRefHandler, {**handler_opts}),
+            (r"/api/v1/lookup/grid", APILookupGridHandler, {**handler_opts}),
+            (r"/api/v1/spot", APISpotHandler, {"spots": self._spots, **handler_opts}),
         ]
 
         # If in API-only mode, serve a basic homepage; in normal mode, serve the usual UI routes
@@ -123,7 +112,7 @@ class WebServer:
             (r"/static/(.*)", StaticFileHandler, {"path": os.path.join(_HERE, "../static")})
         ]
 
-        app = tornado.web.Application(api_routes + v1_compat_routes + ui_routes + misc_routes,
+        app = tornado.web.Application(api_routes + ui_routes + misc_routes,
                                       template_path=os.path.join(_HERE, "../templates"),
                                       log_function=request_log,
                                       debug=False)

solarconditionsproviders/giroionosonde.py

@@ -30,7 +30,7 @@ class GIROIonosonde(SolarConditionsProvider):
     data, but is less reliable and often offline."""
 
     def __init__(self, provider_config):
-        super().__init__(provider_config)
+        super().__init__("GIRO Ionosonde Data", provider_config)
         self._stations = self._load_stations()
         self._thread = None
         self._stop_event = Event()

solarconditionsproviders/hamqsl.py

@@ -15,7 +15,7 @@ class HamQSL(HTTPSolarConditionsProvider):
     Provides solar flux index, geomagnetic indices, and HF/VHF propagation condition summaries."""
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, URL, POLL_INTERVAL)
+        super().__init__("HamQSL", provider_config, URL, POLL_INTERVAL)
 
     def _http_response_to_solar_conditions(self, http_response):
         root = ElementTree.fromstring(http_response.text)

solarconditionsproviders/http_solar_conditions_provider.py

@@ -14,8 +14,8 @@ class HTTPSolarConditionsProvider(SolarConditionsProvider):
     """Generic solar conditions provider for providers that request data via HTTP(S). Subclasses implement
     _http_response_to_solar_conditions() to parse the specific API response format."""
 
-    def __init__(self, provider_config, url, poll_interval):
-        super().__init__(provider_config)
+    def __init__(self, name, provider_config, url, poll_interval):
+        super().__init__(name, provider_config)
         self._url = url
         self._poll_interval = poll_interval
         self._thread = None

solarconditionsproviders/kc2gprop.py

@@ -24,7 +24,7 @@ class KC2GProp(SolarConditionsProvider):
     online, but has fewer stations and does not provide LUF data."""
 
     def __init__(self, provider_config):
-        super().__init__(provider_config)
+        super().__init__("KC2G Propagation Data", provider_config)
         self._thread = None
         self._stop_event = Event()
 

solarconditionsproviders/noaa3dayforecast.py

@@ -13,7 +13,7 @@ class NOAA3dayForecast(HTTPSolarConditionsProvider):
     corresponding fields in the solar conditions object.."""
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, URL, POLL_INTERVAL)
+        super().__init__("NOAA 3-day Forecast", provider_config, URL, POLL_INTERVAL)
 
     @staticmethod
     def _parse_percentage_table(lines, section_header, year):

solarconditionsproviders/solar_conditions_provider.py

@@ -7,11 +7,11 @@ class SolarConditionsProvider:
     """Generic solar conditions provider class. Subclasses of this query individual APIs for space weather and
      propagation data."""
 
-    def __init__(self, provider_config):
+    def __init__(self, name, provider_config):
         """Constructor"""
 
         self._solar_conditions_cache = None
-        self.name = provider_config["name"]
+        self.name = name
         self.enabled = provider_config["enabled"]
         self.last_update_time = datetime.min.replace(tzinfo=pytz.UTC)
         self.status = "Not Started" if self.enabled else "Disabled"

spothole.py

@@ -102,21 +102,18 @@ if __name__ == '__main__':
     # Set up lookup helper
     lookup_helper.start()
 
-    # Create spot providers
+    # Set up web server
+    web_server = WebServer(spots=spots, alerts=alerts, solar_conditions=solar_conditions, status_data=status_data)
+
+    # Fetch, set up and start spot providers
     for entry in config["spot-providers"]:
         spot_providers.append(get_spot_provider_from_config(entry))
-
-    # Set up web server
-    web_server = WebServer(spots=spots, alerts=alerts, solar_conditions=solar_conditions, status_data=status_data,
-                           spot_providers=spot_providers)
-
-    # Set up and start spot providers
     for p in spot_providers:
         p.setup(spots=spots, web_server=web_server)
         if p.enabled:
             p.start()
 
-    # Create, set up and start alert providers
+    # Fetch, set up and start alert providers
     for entry in config["alert-providers"]:
         alert_providers.append(get_alert_provider_from_config(entry))
     for p in alert_providers:
@@ -124,7 +121,7 @@ if __name__ == '__main__':
         if p.enabled:
             p.start()
 
-    # Create, set up and start solar conditions providers
+    # Fetch, set up and start solar conditions providers
     for entry in config.get("solar-condition-providers", []):
         solar_condition_providers.append(get_solar_conditions_provider_from_config(entry))
     for p in solar_condition_providers:

spotproviders/aprsis.py

@@ -14,7 +14,7 @@ class APRSIS(SpotProvider):
     """Spot provider for the APRS-IS."""
 
     def __init__(self, provider_config):
-        super().__init__(provider_config)
+        super().__init__("APRS-IS", provider_config)
         self._thread = Thread(target=self._connect)
         self._thread.daemon = True
         self._aprsis = None

spotproviders/dxcluster.py

@@ -26,7 +26,8 @@ class DXCluster(SpotProvider):
     def __init__(self, provider_config):
         """Constructor requires hostname and port"""
 
-        super().__init__(provider_config)
+        name = provider_config["name"] if "name" in provider_config else "Cluster"
+        super().__init__(name, provider_config)
         self._hostname = provider_config["host"]
         self._port = provider_config["port"]
         self._login_prompt = provider_config["login_prompt"] if "login_prompt" in provider_config else "login:"
@@ -59,6 +60,10 @@ class DXCluster(SpotProvider):
                     self._telnet.write((self._login_callsign + "\n").encode("latin-1"))
                     connected = True
                     logging.info("DX Cluster " + self._hostname + " connected.")
+                except ConnectionRefusedError:
+                    self.status = "Error"
+                    logging.warning("Connection refused to DX cluster " + self._hostname)
+                    sleep(300)
                 except Exception:
                     self.status = "Error"
                     logging.exception("Exception while connecting to DX Cluster Provider (" + self._hostname + ").")

spotproviders/gma.py

@@ -26,7 +26,7 @@ class GMA(HTTPSpotProvider):
             provider_config["enabled"] = False
             logging.warning("GMA spot provider configured but no api key was provided, this API will not be queried.")
 
-        super().__init__(provider_config, self.SPOTS_URL + "?key=" + self.api_key, self.POLL_INTERVAL_SEC)
+        super().__init__("GMA", provider_config, self.SPOTS_URL + "?key=" + self.api_key, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_spots(self, http_response):
         new_spots = []
@@ -112,11 +112,3 @@ class GMA(HTTPSpotProvider):
             logging.warning(f"The GMA API returned an unexpected response (HTTP {http_response.status_code}).")
 
         return new_spots
-
-    def can_submit_spot(self, sig):
-        return sig == "GMA"
-
-    def submit_spot(self, spot, credentials):
-        # TODO: Implement.
-        # Spotting to GMA is documented: https://www.cqgma.org/api/doc/apigma_spot.pdf We (or the user) need a GMA account, and to send the password in plaintext(!!)
-        raise NotImplementedError("GMA upstream spot submission is not yet implemented")

spotproviders/hema.py

@@ -25,7 +25,7 @@ class HEMA(HTTPSpotProvider):
     SPOTTER_COMMENT_PATTERN = re.compile("^\\((.*)\\) (.*)$")
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.SPOT_SEED_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("HEMA", provider_config, self.SPOT_SEED_URL, self.POLL_INTERVAL_SEC)
         self._spot_seed = ""
 
     def _http_response_to_spots(self, http_response):
@@ -73,11 +73,3 @@ class HEMA(HTTPSpotProvider):
             except ConnectionError:
                 logging.warning("Connection error when accessing HEMA spots API.")
         return new_spots
-
-    def can_submit_spot(self, sig):
-        return sig == "HEMA"
-
-    def submit_spot(self, spot, credentials):
-        # TODO: Implement. Currently blocked awaiting their API team to make a change to allow us to spot with a
-        # reference and not a reference *number*.
-        raise NotImplementedError("HEMA upstream spot submission is not yet implemented")

spotproviders/http_spot_provider.py

@@ -15,13 +15,12 @@ class HTTPSpotProvider(SpotProvider):
     """Generic spot provider class for providers that request data via HTTP(S). Just for convenience to avoid code
     duplication. Subclasses of this query the individual APIs for data."""
 
-    def __init__(self, provider_config, url, poll_interval):
-        super().__init__(provider_config)
+    def __init__(self, name, provider_config, url, poll_interval):
+        super().__init__(name, provider_config)
         self._url = url
         self._poll_interval = poll_interval
         self._thread = None
         self._stop_event = Event()
-        self._wakeup_event = Event()
 
     def start(self):
         # Fire off the polling thread. It will poll immediately on startup, then sleep for poll_interval between
@@ -32,19 +31,11 @@ class HTTPSpotProvider(SpotProvider):
 
     def stop(self):
         self._stop_event.set()
-        self._wakeup_event.set()
-
-    def force_poll(self):
-        """Trigger an immediate poll without waiting for the normal interval."""
-
-        self._wakeup_event.set()
 
     def _run(self):
         while True:
-            self._wakeup_event.clear()
             self._poll()
-            self._wakeup_event.wait(timeout=self._poll_interval)
-            if self._stop_event.is_set():
+            if self._stop_event.wait(timeout=self._poll_interval):
                 break
 
     def _poll(self):

spotproviders/llota.py

@@ -12,7 +12,7 @@ class LLOTA(HTTPSpotProvider):
     SPOTS_URL = "https://llota.app/api/public/spots"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("LLOTA", provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_spots(self, http_response):
         new_spots = []

spotproviders/parksnpeaks.py

@@ -3,9 +3,7 @@ import re
 from datetime import datetime
 
 import pytz
-import requests
 
-from core.constants import HTTP_HEADERS
 from data.sig_ref import SIGRef
 from data.spot import Spot
 from spotproviders.http_spot_provider import HTTPSpotProvider
@@ -16,12 +14,10 @@ class ParksNPeaks(HTTPSpotProvider):
 
     POLL_INTERVAL_SEC = 120
     SPOTS_URL = "https://www.parksnpeaks.org/api/ALL"
-    SUBMIT_URL = "https://www.parksnpeaks.org/api/SPOT/"
     SIOTA_LIST_URL = "https://www.silosontheair.com/data/silos.csv"
-    SUBMITTABLE_SIGS = ["POTA", "SOTA", "WWFF", "HEMA", "WOTA", "ZLOTA", "SIOTA", "KRMNPA"]
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("ParksNPeaks", provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_spots(self, http_response):
         new_spots = []
@@ -67,28 +63,3 @@ class ParksNPeaks(HTTPSpotProvider):
                 # Add new spot to the list
                 new_spots.append(spot)
         return new_spots
-
-    def can_submit_spot(self, sig):
-        return sig in self.SUBMITTABLE_SIGS
-
-    def submit_spot(self, spot, credentials):
-        # TODO test this works
-        user_id = credentials.get("user_id", "")
-        api_key = credentials.get("api_key", "")
-        if not user_id or not api_key:
-            raise ValueError(
-                "Parks N Peaks user ID and API key are required. Get yours from your Parks N Peaks account.")
-        sig_ref = spot.sig_refs[0].id if spot.sig_refs else ""
-        body = {
-            "actClass": spot.sig or "",
-            "actCallsign": spot.dx_call,
-            "actSite": sig_ref,
-            "mode": spot.mode or "",
-            "freq": str(spot.freq / 1000000.0),
-            "comments": spot.comment or "",
-            "userID": user_id,
-            "APIKey": api_key,
-        }
-        response = requests.post(self.SUBMIT_URL, json=body, headers=HTTP_HEADERS, timeout=(5, 30))
-        if not response.ok:
-            raise RuntimeError("Parks N Peaks API returned " + str(response.status_code) + ": " + response.text)

spotproviders/pota.py

@@ -1,9 +1,7 @@
 from datetime import datetime
 
 import pytz
-import requests
 
-from core.constants import HTTP_HEADERS
 from data.sig_ref import SIGRef
 from data.spot import Spot
 from spotproviders.http_spot_provider import HTTPSpotProvider
@@ -14,10 +12,9 @@ class POTA(HTTPSpotProvider):
 
     POLL_INTERVAL_SEC = 120
     SPOTS_URL = "https://api.pota.app/spot/activator"
-    SUBMIT_URL = "https://api.pota.app/spot"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("POTA", provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_spots(self, http_response):
         new_spots = []
@@ -43,25 +40,3 @@ class POTA(HTTPSpotProvider):
             # that for us.
             new_spots.append(spot)
         return new_spots
-
-    def can_submit_spot(self, sig):
-        return sig == "POTA"
-
-    def submit_spot(self, spot, credentials):
-        sig_ref = spot.sig_refs[0].id if spot.sig_refs else None
-        if sig_ref:
-            body = {
-                "activator": spot.dx_call,
-                "spotter": spot.de_call,
-                "frequency": str(spot.freq / 1000.0),
-                "mode": spot.mode or "",
-                "reference": sig_ref,
-                "comments": spot.comment or "",
-                "source": "Spothole",
-            }
-            headers = {**HTTP_HEADERS, "Content-Type": "application/json"}
-            response = requests.post(self.SUBMIT_URL, json=body, headers=headers, timeout=(5, 30))
-            if not response.ok:
-                raise RuntimeError("POTA API returned " + str(response.status_code) + ": " + response.text)
-        else:
-            raise RuntimeError("Park reference is required for submitting POTA spots.")

spotproviders/rbn.py

@@ -23,7 +23,8 @@ class RBN(SpotProvider):
     def __init__(self, provider_config):
         """Constructor requires port number."""
 
-        super().__init__(provider_config)
+        name = provider_config["name"] if "name" in provider_config else "RBN"
+        super().__init__(name, provider_config)
         self._port = provider_config["port"]
         self._telnet = None
         self._thread = Thread(target=self._handle)

spotproviders/sota.py

@@ -4,7 +4,7 @@ from datetime import datetime
 import requests
 from requests.exceptions import ConnectionError, ReadTimeout, ConnectTimeout
 
-from core.constants import HTTP_HEADERS, SSB_SUB_MODES, DV_SUB_MODES
+from core.constants import HTTP_HEADERS
 from data.sig_ref import SIGRef
 from data.spot import Spot
 from spotproviders.http_spot_provider import HTTPSpotProvider
@@ -22,11 +22,8 @@ class SOTA(HTTPSpotProvider):
     # SOTA spots don't contain lat/lon, we need a separate lookup for that
     SUMMIT_URL_ROOT = "https://api-db2.sota.org.uk/api/summits/"
 
-    SUBMIT_URL = "https://api-db2.sota.org.uk/api/spots"
-    VALID_MODES = ["AM", "CW", "Data", "DV", "FM", "SSB"]
-
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.EPOCH_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("SOTA", provider_config, self.EPOCH_URL, self.POLL_INTERVAL_SEC)
         self._api_epoch = ""
 
     def _http_response_to_spots(self, http_response):
@@ -66,46 +63,3 @@ class SOTA(HTTPSpotProvider):
             except (ConnectTimeout, ReadTimeout):
                 logging.warning(f"Timeout when accessing SOTA spots API.")
         return new_spots
-
-    def can_submit_spot(self, sig):
-        return sig == "SOTA"
-
-    def submit_spot(self, spot, credentials):
-        # TODO test this method works
-        access_token = credentials.get("access_token", "")
-        id_token = credentials.get("id_token", "")
-        if not access_token or not id_token:
-            raise ValueError("SOTA API tokens are required. Please log into SOTA in order to spot to it.")
-        sig_ref = spot.sig_refs[0].id if spot.sig_refs else ""
-        if sig_ref:
-            # Split reference into association and summit codes
-            ref_split = sig_ref.split("/")
-
-            # Figure out a valid mode. Borrowed this from PoLo :)
-            # https://github.com/ham2k/app-polo/blob/main/src/extensions/activities/sota/SOTAPostSelfSpot.js
-            mode = spot.mode
-            if mode and mode not in self.VALID_MODES:
-                if mode in SSB_SUB_MODES:
-                    mode = "SSB"
-                elif mode in DV_SUB_MODES:
-                    mode = "DV"
-                else:
-                    mode = "Data"
-
-            body = {
-                "activatorCallsign": spot.dx_call,
-                "associationCode": ref_split[0],
-                "summitCode": ref_split[1],
-                "frequency": spot.freq / 1000000.0,
-                "mode": mode or "",
-                "callsign": spot.de_call,
-                "comments": spot.comment or "",
-                "type": "TEST"  # todo replatce with NORMAL/QRT once testing complete
-            }
-            headers = {**HTTP_HEADERS, "Authorization": "bearer " + access_token, "id_token": id_token,
-                       "Content-Type": "application/json"}
-            response = requests.post(self.SUBMIT_URL, json=body, headers=headers, timeout=(5, 30))
-            if not response.ok:
-                raise RuntimeError("SOTA API returned " + str(response.status_code) + ": " + response.text)
-        else:
-            raise RuntimeError("Summit reference is required for submitting SOTA spots.")

spotproviders/spot_provider.py

@@ -8,10 +8,10 @@ from core.config import MAX_SPOT_AGE
 class SpotProvider:
     """Generic spot provider class. Subclasses of this query the individual APIs for data."""
 
-    def __init__(self, provider_config):
+    def __init__(self, name, provider_config):
         """Constructor"""
 
-        self.name = provider_config["name"]
+        self.name = name
         self.enabled = provider_config["enabled"]
         self.last_update_time = datetime.min.replace(tzinfo=pytz.UTC)
         self.last_spot_time = datetime.min.replace(tzinfo=pytz.UTC)
@@ -68,20 +68,3 @@ class SpotProvider:
         """Stop any threads and prepare for application shutdown"""
 
         raise NotImplementedError("Subclasses must implement this method")
-
-    def can_submit_spot(self, sig):
-        """Return True if this provider supports submitting spots upstream for the given SIG."""
-
-        return False
-
-    def submit_spot(self, spot, credentials):
-        """Submit a spot upstream to this provider's API. credentials is a dict with provider-specific keys.
-        Raises an exception with a descriptive message on failure."""
-
-        raise NotImplementedError("This provider does not support spot submission")
-
-    def force_poll(self):
-        """Trigger an immediate poll without waiting for the normal interval. Default implementation here does nothing
-        because not all spot providers have a polling mechanism. Providers that do should override this method."""
-
-        return

spotproviders/sse_spot_provider.py

@@ -13,8 +13,8 @@ from spotproviders.spot_provider import SpotProvider
 class SSESpotProvider(SpotProvider):
     """Spot provider using Server-Sent Events."""
 
-    def __init__(self, provider_config, url):
-        super().__init__(provider_config)
+    def __init__(self, name, provider_config, url):
+        super().__init__(name, provider_config)
         self._url = url
         self._event_source = None
         self._thread = None

spotproviders/tiles.py

@@ -1,8 +1,5 @@
 from datetime import datetime
 
-import requests
-
-from core.constants import HTTP_HEADERS, SSB_SUB_MODES
 from data.sig_ref import SIGRef
 from data.spot import Spot
 from spotproviders.http_spot_provider import HTTPSpotProvider
@@ -13,12 +10,9 @@ class Tiles(HTTPSpotProvider):
 
     POLL_INTERVAL_SEC = 120
     SPOTS_URL = "https://icneuzxitdqtofutxbla.supabase.co/functions/v1/spots?active_hours=24"
-    SUBMIT_URL = "https://icneuzxitdqtofutxbla.supabase.co/functions/v1/self-spot"
-    VALID_MODES = ["SSB", "CW", "FT8", "FT4", "FM", "DMR", "D-STAR", "M17", "AX.25", "JS8Call", "PSK31", "Olivia",
-                   "VarAC", "Other"]
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("Tiles", provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_spots(self, http_response):
         new_spots = []
@@ -48,49 +42,6 @@ class Tiles(HTTPSpotProvider):
             new_spots.append(spot)
         return new_spots
 
-    def can_submit_spot(self, sig):
-        return sig == "Tiles"
-
-    def submit_spot(self, spot, credentials):
-        # Tiles on the air currently only supports *self* spots
-        if spot.dx_call == spot.de_call:
-
-            # Figure out a valid mode. Borrowed this from PoLo :)
-            # https://github.com/ham2k/app-polo/blob/main/src/extensions/activities/sota/SOTAPostSelfSpot.js
-            if spot.mode:
-                mode = spot.mode
-                if mode not in self.VALID_MODES:
-                    if mode in SSB_SUB_MODES:
-                        mode = "SSB"
-                    elif mode == "OLIVIA":
-                        mode = "Olivia"
-                    elif mode == "JS8":
-                        mode = "JS8Call"
-                    else:
-                        mode = "Other"
-
-                body = {
-                    "call_sign": spot.dx_call,
-                    "frequency": str(spot.freq / 1000000.0),
-                    "mode": mode or "",
-                    "grid": spot.dx_grid or "",
-                    "comment": spot.comment or "",
-                    "lat": spot.dx_latitude or None,
-                    "lon": spot.dx_longitude or None,
-                    "qrt": spot.qrt or False,
-                    "pin": credentials.get("offline_spot_gateway_pin", "")
-                }
-                headers = {**HTTP_HEADERS, "Content-Type": "application/json"}
-                response = requests.post(self.SUBMIT_URL, json=body, headers=headers, timeout=(5, 30))
-                if not response.ok:
-                    raise RuntimeError(
-                        "Tiles on the Air API returned " + str(response.status_code) + ": " + response.text)
-            else:
-                raise RuntimeError("The Tiles on the Air API requires a mode to be set.")
-        else:
-            raise RuntimeError(
-                "The Tiles on the Air API only supports self-spots, the DX call and spotter call must match.")
-
 
 # Utility function to keep the first decimal point in a given string but remove any others. Used to parse Tiles'
 # strange frequency format where we can sometimes have e.g. "14.123.5".

spotproviders/towers.py

@@ -13,7 +13,7 @@ class Towers(HTTPSpotProvider):
     SPOTS_URL = "https://wwtota.com/api/cluster_live.php"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("Towers", provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_spots(self, http_response):
         new_spots = []

spotproviders/ukpacketnet.py

@@ -14,7 +14,7 @@ class UKPacketNet(HTTPSpotProvider):
     SPOTS_URL = "https://nodes.ukpacketradio.network/api/nodedata"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("UK Packet Net", provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_spots(self, http_response):
         new_spots = []

spotproviders/websocket_spot_provider.py

@@ -13,8 +13,8 @@ from spotproviders.spot_provider import SpotProvider
 class WebsocketSpotProvider(SpotProvider):
     """Spot provider using websockets."""
 
-    def __init__(self, provider_config, url):
-        super().__init__(provider_config)
+    def __init__(self, name, provider_config, url):
+        super().__init__(name, provider_config)
         self._url = url
         self._ws = None
         self._thread = None

spotproviders/wota.py

@@ -21,7 +21,7 @@ class WOTA(HTTPSpotProvider):
     RSS_DATE_TIME_FORMAT = "%a, %d %b %Y %H:%M:%S %z"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("WOTA", provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_spots(self, http_response):
         new_spots = []
@@ -79,10 +79,3 @@ class WOTA(HTTPSpotProvider):
             except Exception as e:
                 logging.error("Exception parsing WOTA spot", e)
         return new_spots
-
-    def can_submit_spot(self, sig):
-        return sig == "WOTA"
-
-    def submit_spot(self, spot, credentials):
-        # TODO Ask M5TEA if he's happy to share how this is done from his app
-        raise NotImplementedError("WOTA upstream spot submission is not yet implemented")

spotproviders/wwbota.py

@@ -12,7 +12,7 @@ class WWBOTA(SSESpotProvider):
     SPOTS_URL = "https://api.wwbota.net/spots/"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.SPOTS_URL)
+        super().__init__("WWBOTA", provider_config, self.SPOTS_URL)
 
     def _sse_message_to_spot(self, message):
         source_spot = json.loads(message)
@@ -41,10 +41,3 @@ class WWBOTA(SSESpotProvider):
 
         # WWBOTA does support a special "Test" spot type, we need to avoid adding that.
         return spot if source_spot["type"] != "Test" else None
-
-    def can_submit_spot(self, sig):
-        return sig == "WWBOTA"
-
-    def submit_spot(self, spot, credentials):
-        # TODO: Implement. WWBOTA API docs cover this: https://api.wwbota.org/#tag/Spots/operation/create_spot_spots__post
-        raise NotImplementedError("WWBOTA upstream spot submission is not yet implemented")

spotproviders/wwff.py

@@ -14,7 +14,7 @@ class WWFF(HTTPSpotProvider):
     SPOTS_URL = "https://spots.wwff.co/static/spots.json"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("WWFF", provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_spots(self, http_response):
         new_spots = []
@@ -38,11 +38,3 @@ class WWFF(HTTPSpotProvider):
             # that for us.
             new_spots.append(spot)
         return new_spots
-
-    def can_submit_spot(self, sig):
-        return sig == "WWFF"
-
-    def submit_spot(self, spot, credentials):
-        # TODO: Implement. Spotting to WWFF should be possible, need to look up the Spotline docs or copy approach from
-        # PoLo. Either way I think we need an API key for the app (but maybe not for the user?)
-        raise NotImplementedError("WWFF upstream spot submission is not yet implemented")

spotproviders/xota.py

@@ -21,7 +21,8 @@ class XOTA(WebsocketSpotProvider):
     SIG = None
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, provider_config["url"])
+        name = provider_config["name"] if "name" in provider_config else "xOTA"
+        super().__init__(name, provider_config, provider_config["url"])
         locations_csv = str(provider_config["locations-csv"]) if "locations-csv" in provider_config else None
         self.SIG = str(provider_config["sig"]) if "sig" in provider_config else None
 

spotproviders/zlota.py

@@ -15,7 +15,7 @@ class ZLOTA(HTTPSpotProvider):
     LIST_URL = "https://ontheair.nz/assets/assets.json"
 
     def __init__(self, provider_config):
-        super().__init__(provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
+        super().__init__("ZLOTA", provider_config, self.SPOTS_URL, self.POLL_INTERVAL_SEC)
 
     def _http_response_to_spots(self, http_response):
         new_spots = []
@@ -41,10 +41,3 @@ class ZLOTA(HTTPSpotProvider):
 
             new_spots.append(spot)
         return new_spots
-
-    def can_submit_spot(self, sig):
-        return sig == "ZLOTA"
-
-    def submit_spot(self, spot, credentials):
-        # TODO: Implement. Spotting to ZLOTA is supported via POST, see https://ontheair.nz/api
-        raise NotImplementedError("ZLOTA upstream spot submission is not yet implemented")

static/apidocs/openapi.yml

@@ -15,14 +15,6 @@ info:
 
     ## Changelog
     
-    ### 2.0
-
-    * POST `/spot` now supports upstream submission to the spotting services associated with various SIGs.
-    * **Breaking change:** The "add spot" API has changed to enable this: instead of just posting the spot object itself as the JSON content of the POST, this has moved into a `spot` object within the structure. A new `handling` object alongside it contains the `submit_upstream`, `upstream_provider`, `upstream_credentials`, and `captcha_token` fields which control the server handling of the spot.
-    * POST `/spot` now supports Google reCaptcha and (if the site owner has set it up) now requires `captcha_token` in order to successfully submit. (This is used to lock down the submit function and prevent submission via Spothole by bots or third-party clients.)
-    * GET `/options` now returns `spot_submit_providers`, a map of SIG names to the names of providers that support upstream spot submission for that SIG. (This allows clients to present the user with options of where a new spot can be sent to.)
-    * **Breaking change:** A user's QRZ.com and HamQTH credentials are now supplied as request headers (`X-QRZ-Username`, `X-QRZ-Password`, `X-QRZ-Session-Key`, `X-HamQTH-Username`, `X-HamQTH-Password`, `X-HamQTH-Session-ID`) rather than query parameters, to keep credentials out of server logs.
-
     ### 1.4
     
     * Spots can now include a "propagation_mode" field, and the `/options` call enumerates the options that can have.
@@ -53,10 +45,10 @@ info:
   license:
     name: The Unlicense
     url: https://unlicense.org/#the-unlicense
-  version: 2.0
+  version: v1.4
 
 servers:
-  - url: https://spothole.app/api/v2
+  - url: https://spothole.app/api/v1
 
 tags:
   - name: Spots
@@ -337,8 +329,7 @@ paths:
           content:
             application/json:
               schema:
-                type: string
-                example: "Failed"
+                $ref: '#/components/schemas/ErrorResponse'
 
 
   /lookup/sigref:
@@ -366,8 +357,7 @@ paths:
           content:
             application/json:
               schema:
-                type: string
-                example: "Failed"
+                $ref: '#/components/schemas/ErrorResponse'
 
 
 
@@ -393,8 +383,7 @@ paths:
           content:
             application/json:
               schema:
-                type: string
-                example: "Failed"
+                $ref: '#/components/schemas/ErrorResponse'
 
 
   /spot:
@@ -403,53 +392,50 @@ paths:
         - Spots
       summary: Add a spot
       description: >
-        Supply a JSON object containing a `spot` sub-object (the spot data) and an optional `handling` sub-object
-        containing server-side instructions such as upstream submission). Check `spot_submit_providers` in the
-        `/options` response to see which SIGs and providers support upstream submission. cURL example:
-        `curl --request POST --header \"Content-Type: application/json\" --data '{\"spot\":{\"dx_call\":\"M0TRT\",\"time\":1760019539,\"freq\":14200000,\"comment\":\"Test spot please ignore\",\"de_call\":\"M0TRT\"}}' https://spothole.app/api/v2/spot`"
+        Supply a new spot object, which will be added to the system. Currently, this will not be
+        reported up the chain to a cluster, POTA, SOTA etc. This may be introduced in a future version.
+        cURL example: `curl --request POST --header "Content-Type: application/json" --data
+        '{"dx_call":"M0TRT","time":1760019539, "freq":14200000, "comment":"Test spot please ignore",
+        "de_call":"M0TRT"}' https://spothole.app/api/v1/spot`
       operationId: spot
       requestBody:
-        description: Object containing a "spot" sub-object with the spot data, and an optional "handling" sub-object with server-side instructions of what to do with it.
+        description: The JSON spot object
         required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/SpotSubmission'
+              $ref: '#/components/schemas/Spot'
       responses:
-        '201':
+        '200':
           description: Success
           content:
             application/json:
               schema:
-                type: string
-                example: "OK"
+                $ref: '#/components/schemas/OkResponse'
         '415':
           description: Incorrect Content-Type
           content:
             application/json:
               schema:
-                type: string
-                example: "Failed"
+                $ref: '#/components/schemas/ErrorResponse'
         '422':
           description: Validation error
           content:
             application/json:
               schema:
-                type: string
-                example: "Failed"
+                $ref: '#/components/schemas/ErrorResponse'
         '500':
           description: Internal server error
           content:
             application/json:
               schema:
-                type: string
-                example: "Failed"
+                $ref: '#/components/schemas/ErrorResponse'
 
 components:
   parameters:
     QrzUsername:
-      name: X-QRZ-Username
-      in: header
+      name: qrz_username
+      in: query
       description: >
         QRZ.com username for online callsign lookup, which will enrich the returned spots and alerts
         with extra data. Requires a QRZ.com XML Subscriber (paid) account. Supply together with
@@ -457,14 +443,14 @@ components:
       schema:
         type: string
     QrzPassword:
-      name: X-QRZ-Password
-      in: header
+      name: qrz_password
+      in: query
       description: QRZ.com password. Supply together with `qrz_username`.
       schema:
         type: string
     QrzSessionKey:
-      name: X-QRZ-Session-Key
-      in: header
+      name: qrz_session_key
+      in: query
       description: >
         A pre-obtained QRZ.com XML session key, as an alternative to supplying `qrz_username` and
         `qrz_password`. See https://www.qrz.com/docs/xml/current_spec.html for details on how to
@@ -472,22 +458,22 @@ components:
       schema:
         type: string
     HamqthUsername:
-      name: X-HamQTH-Username
-      in: header
+      name: hamqth_username
+      in: query
       description: >
         HamQTH username for online callsign lookup, which will enrich the returned spots and alerts
         with extra data. Supply together with `hamqth_password`, or supply `hamqth_session_id` instead.
       schema:
         type: string
     HamqthPassword:
-      name: X-HamQTH-Password
-      in: header
+      name: hamqth_password
+      in: query
       description: HamQTH password. Supply together with `hamqth_username`.
       schema:
         type: string
     HamqthSessionId:
-      name: X-HamQTH-Session-ID
-      in: header
+      name: hamqth_session_id
+      in: query
       description: >
         A pre-obtained HamQTH session ID, as an alternative to supplying `hamqth_username` and
         `hamqth_password`. See https://www.hamqth.com/developers.php for details on how to retrieve
@@ -1198,54 +1184,6 @@ components:
           $ref: "#/components/schemas/PropagationMode"
 
 
-    SpotSubmission:
-      description: >
-        Request body for POST /spot. Contains a "spot" sub-object with the spot data, and an optional
-        "handling" sub-object with server-side instructions consumed by Spothole.
-      type: object
-      required:
-        - spot
-      properties:
-        spot:
-          $ref: '#/components/schemas/Spot'
-        handling:
-          type: object
-          description: >
-            Optional server-side instructions for how to process this spot submission.
-          properties:
-            submit_upstream:
-              type: boolean
-              description: >
-                If true, forward the spot to an external upstream provider (e.g. POTA, SOTA) rather
-                than only adding it to this Spothole server. Requires `sig`, at least one `sig_refs`
-                entry, and `upstream_provider` to be set. Check `spot_submit_providers` in the
-                /options response to see which SIGs and providers support this.
-              default: false
-            upstream_provider:
-              type: string
-              description: >
-                Name of the upstream provider to submit the spot to, e.g. "POTA" or "SOTA". Must
-                match one of the provider names returned in `spot_submit_providers` for the chosen SIG.
-              example: POTA
-            upstream_credentials:
-              type: object
-              description: >
-                Provider-specific credentials required to authenticate the upstream submission.
-                The required keys depend on the provider. Credentials are used only for the upstream
-                call and are never stored by Spothole.
-              additionalProperties:
-                type: string
-              example:
-                user_id: "12345"
-                api_key: "abc123"
-            captcha_token:
-              type: string
-              description: >
-                A Google reCAPTCHA v2 response token. Required when submitting upstream if the
-                server has reCAPTCHA configured. Obtain the token by completing the reCAPTCHA
-                widget rendered on the Add Spot page.
-              example: "03AFY_a8Xq..."
-
     SpotStream:
       type: object
       description: A server-sent event containing a spot
@@ -1792,6 +1730,14 @@ components:
       items:
         $ref: '#/components/schemas/Alert'
 
+    OkResponse:
+      type: string
+      example: "OK"
+
+    ErrorResponse:
+      type: string
+      example: "Failed"
+
     DxStats:
       type: object
       description: Spot counts keyed by DE continent
@@ -1929,7 +1875,7 @@ components:
           type: integer
           description: >
             The maximum age, in seconds, of any spot before it will be deleted by the system. When
-            querying the /api/v2/spots endpoint and providing a "max_age" or "since" parameter, there
+            querying the /api/v1/spots endpoint and providing a "max_age" or "since" parameter, there
             is no point providing a number larger than this, because the system drops all spots older
             than this.
           example: 3600
@@ -1939,20 +1885,6 @@ components:
             Whether the POST /spot call, to add spots to the server directly via its API, is permitted
             on this server.
           example: true
-        spot_submit_providers:
-          type: object
-          description: >
-            A map of SIG name to a list of provider names that support upstream spot submission for that SIG.
-            If a SIG appears as a key here, the POST /spot endpoint accepts `submit_upstream: true` for
-            spots with that SIG, and will forward the spot to one of the listed providers. Omitted if no
-            providers support upstream submission.
-          additionalProperties:
-            type: array
-            items:
-              type: string
-          example:
-            POTA: [ POTA ]
-            SOTA: [ SOTA, GMA, ParksNPeaks ]
 
     CallLookup:
       type: object

static/js/add-spot.js

@@ -1,35 +1,7 @@
-// Credentials schema per provider name. Defines the fields to collect and how to label them.
-const PROVIDER_CREDENTIAL_SCHEMAS = {
-    // todo Figure out SOTA authentication
-    // see e.g. https://github.com/ham2k/app-polo/blob/main/src/extensions/activities/sota/SOTAAccount.jsx
-    //          https://github.com/ham2k/app-polo/blob/main/src/store/apis/apiSOTA/apiSOTA.js
-    // Refresh token? Way to show user that they need to log in again because cached credentials aren't valid?
-    // todo type: text/password distinction on text boxes so API keys can be obscured
-    "SOTA": [
-        {key: "access_token", label: "SOTA Access Token", help: ""},
-        {key: "id_token", label: "SOTA ID Token", help: "TODO SOTA authentication to provide this..."}
-    ],
-    "ParksNPeaks": [
-        {key: "user_id", label: "Parks N Peaks User ID", help: ""},
-        {key: "api_key", label: "Parks N Peaks API Key", help: "Get your API key from your Parks N Peaks account."}
-    ],
-    "ZLOTA": [
-        {key: "user_id", label: "ZLOTA User ID", help: ""},
-        {key: "api_key", label: "ZLOTA User PIN", help: "Get your PIN from your ZLOTA account."}
-    ],
-    "Tiles": [
-        {
-            key: "offline_spot_gateway_pin",
-            label: "Offline Spot Gateway PIN",
-            help: "Get your PIN from your Tiles on the Air account profile."
-        }
-    ]
-};
-
 // Load server options. Once a successful callback is made from this, we can populate the choice boxes in the form and load
 // any saved values from local storage.
 function loadOptions() {
-    $.getJSON('/api/v2/options', function (jsonData) {
+    $.getJSON('/api/v1/options', function (jsonData) {
         // Store options
         options = jsonData;
 
@@ -49,144 +21,11 @@ function loadOptions() {
             }));
         });
 
-        // Load reCAPTCHA if a site key is configured (key is inlined into page by server)
-        if (window._recaptchaSiteKey) {
-            loadRecaptcha(window._recaptchaSiteKey);
-        }
-
         // Load settings from settings storage now all the controls are available
         loadSettings();
-
-        // Update the upstream area for any pre-selected SIG
-        updateUpstreamArea();
     });
 }
 
-// Load and inject the reCAPTCHA script
-function loadRecaptcha(siteKey) {
-    window._recaptchaSiteKey = siteKey;
-    if (!document.getElementById('recaptcha-script')) {
-        const script = document.createElement('script');
-        script.id = 'recaptcha-script';
-        script.src = 'https://www.google.com/recaptcha/api.js?render=explicit&onload=renderRecaptcha';
-        script.async = true;
-        script.defer = true;
-        document.head.appendChild(script);
-    }
-    $("#recaptcha-area").show();
-}
-
-// Called by reCAPTCHA after its script loads
-function renderRecaptcha() {
-    window._recaptchaWidgetId = grecaptcha.render('recaptcha-widget', {
-        sitekey: window._recaptchaSiteKey,
-        size: 'normal'
-    });
-}
-
-// Update the "Send spot to..." area based on the currently selected SIG
-function updateUpstreamArea() {
-    if (!window._allowUpstreamSpotting || !options || !options["spot_submit_providers"]) {
-        $("#upstream-area").hide();
-        return;
-    }
-
-    const sig = $("#sig").val();
-    const providers = (sig && options["spot_submit_providers"][sig]) ? options["spot_submit_providers"][sig] : [];
-
-    if (providers.length === 0) {
-        $("#upstream-area").hide();
-        return;
-    }
-
-    $("#upstream-area").show();
-
-    // Update the provider selector
-    $("#upstream-provider-select").empty();
-    $.each(providers, function (i, name) {
-        $("#upstream-provider-select").append($('<option>', {value: name, text: name}));
-    });
-
-    if (providers.length > 1) {
-        $("#upstream-provider-label").text("upstream spot sources:");
-        $("#upstream-provider-select-col").show();
-    } else {
-        $("#upstream-provider-label").text(providers[0]);
-        $("#upstream-provider-select-col").hide();
-    }
-
-    // Show the credentials button if this provider has an authentication mechanism and we need input from the user
-    updateCredentialsButton();
-}
-
-// Update the credentials button visibility based on selected provider
-function updateCredentialsButton() {
-    const providerName = getSelectedUpstreamProvider();
-    if (providerName && PROVIDER_CREDENTIAL_SCHEMAS[providerName]) {
-        $("#upstream-credentials-btn").show();
-    } else {
-        $("#upstream-credentials-btn").hide();
-    }
-}
-
-// Get the currently selected upstream provider name
-function getSelectedUpstreamProvider() {
-    const providers = (options && options["spot_submit_providers"] && $("#sig").val())
-        ? (options["spot_submit_providers"][$("#sig").val()] || [])
-        : [];
-    if (providers.length === 0) return null;
-    if (providers.length === 1) return providers[0];
-    return $("#upstream-provider-select").val();
-}
-
-// Show the credentials modal for the currently selected upstream provider
-function showCredentialsModal() {
-    const providerName = getSelectedUpstreamProvider();
-    if (!providerName || !PROVIDER_CREDENTIAL_SCHEMAS[providerName]) return;
-
-    const schema = PROVIDER_CREDENTIAL_SCHEMAS[providerName];
-    const stored = loadCredentials(providerName);
-
-    $("#credentials-provider-name").text(providerName);
-    $("#credentials-fields").empty();
-
-    $.each(schema, function (i, field) {
-        const val = stored[field.key] || "";
-        let html = '<div class="mb-3">';
-        html += '<label for="cred-' + field.key + '" class="form-label">' + field.label + '</label>';
-        html += '<input type="text" class="form-control" id="cred-' + field.key + '" value="' + $('<div>').text(val).html() + '">';
-        if (field.help) {
-            html += '<div class="form-text">' + field.help + '</div>';
-        }
-        html += '</div>';
-        $("#credentials-fields").append(html);
-    });
-
-    // Store provider name for saveCredentials()
-    $("#credentials-modal").data("provider", providerName);
-    new bootstrap.Modal(document.getElementById('credentials-modal')).show();
-}
-
-// Save credentials from the modal to local storage
-function saveCredentials() {
-    const providerName = $("#credentials-modal").data("provider");
-    if (!providerName || !PROVIDER_CREDENTIAL_SCHEMAS[providerName]) return;
-
-    const schema = PROVIDER_CREDENTIAL_SCHEMAS[providerName];
-    const creds = {};
-    $.each(schema, function (i, field) {
-        creds[field.key] = $("#cred-" + field.key).val();
-    });
-    localStorage.setItem("upstream-credentials-" + providerName, JSON.stringify(creds));
-    bootstrap.Modal.getInstance(document.getElementById('credentials-modal')).hide();
-}
-
-// Load credentials for a provider from local storage
-function loadCredentials(providerName) {
-    const stored = localStorage.getItem("upstream-credentials-" + providerName);
-    return stored ? JSON.parse(stored) : {};
-}
-
 // Method called to add a spot to the server
 function addSpot() {
     try {
@@ -203,65 +42,57 @@ function addSpot() {
         const comment = $("#comment").val();
         const de = $("#de-call").val().toUpperCase();
 
-        // Prepare the spot object for the server
         const spot = {};
+        if (dx !== "") {
             spot["dx_call"] = dx;
+        } else {
+            showAddSpotError("A DX callsign is required in order to spot.");
+            return;
+        }
+        if (freqStr !== "") {
             spot["freq"] = parseFloat(freqStr) * 1000;
-        if (mode !== "") spot["mode"] = mode;
-        if (sig !== "") spot["sig"] = sig;
-        if (sigRef !== "") spot["sig_refs"] = [{sig: sig, id: sigRef}];
-        if (dxGrid !== "") spot["dx_grid"] = dxGrid;
-        if (comment !== "") spot["comment"] = comment;
+        } else {
+            showAddSpotError("A frequency is required in order to spot.");
+            return;
+        }
+        if (mode !== "") {
+            spot["mode"] = mode;
+        }
+        if (sig !== "") {
+            spot["sig"] = sig;
+        }
+        if (sigRef !== "") {
+            spot["sig_refs"] = [{sig: sig, id: sigRef}];
+        }
+        if (dxGrid !== "") {
+            spot["dx_grid"] = dxGrid;
+        }
+        if (comment !== "") {
+            spot["comment"] = comment;
+        }
+        if (de !== "") {
             spot["de_call"] = de;
+        } else {
+            showAddSpotError("A spotter callsign is required in order to spot.");
+            return;
+        }
         spot["time"] = moment.utc().valueOf() / 1000.0;
 
-        // Prepare "handling" structure to tell the server what to do with this spot
-        const handling = {};
-
-        // Add CAPTCHA token if reCAPTCHA is loaded
-        if (window._recaptchaWidgetId !== undefined) {
-            handling["captcha_token"] = grecaptcha.getResponse(window._recaptchaWidgetId);
-        }
-
-        // Upstream submission
-        const submitUpstream = $("#submit-upstream").is(":checked");
-        const upstreamProviderName = getSelectedUpstreamProvider();
-        if (submitUpstream && upstreamProviderName) {
-            handling["submit_upstream"] = true;
-            handling["upstream_provider"] = upstreamProviderName;
-            handling["upstream_credentials"] = loadCredentials(upstreamProviderName);
-        }
-
-        $.ajax("/api/v2/spot", {
-            data: JSON.stringify({spot, handling}),
+        $.ajax("/api/v1/spot", {
+            data: JSON.stringify(spot),
             contentType: 'application/json',
             type: 'POST',
             timeout: 10000,
-            success: async function (result) {
-                // Reset CAPTCHA for next use
-                if (window._recaptchaWidgetId !== undefined) {
-                    grecaptcha.reset(window._recaptchaWidgetId);
-                }
-                if (result && result.startsWith && result.startsWith("Warning")) {
-                    $("#result-good").html("<div class='alert alert-warning fade show mb-0 mt-4' role='alert'><i class='fa-solid fa-triangle-exclamation'></i> " + result + " Returning you to the spots list...</div>");
-                } else {
+            success: async function () {
                 $("#result-good").html("<div class='alert alert-success fade show mb-0 mt-4' role='alert'><i class='fa-solid fa-check'></i> Spot submitted. Returning you to the spots list...</div>");
-                }
                 $("#result-bad").html("");
                 setTimeout(() => {
                     $("#result-good").hide();
                     window.location.replace("/");
-                }, 2000);
+                }, 1000);
             },
             error: function (result) {
-                if (window._recaptchaWidgetId !== undefined) {
-                    grecaptcha.reset(window._recaptchaWidgetId);
-                }
-                if (result.responseText) {
                 showAddSpotError(result.responseText.slice(1, -1));
-                } else {
-                    showAddSpotError("The server did not return a response.");
-                }
             }
         });
     } catch (error) {
@@ -290,18 +121,20 @@ $("#mode").change(function () {
     $(this).val($(this).val().trim().toUpperCase());
 });
 
-// Update upstream area and credentials button when SIG changes
-$("#sig").change(function () {
-    updateUpstreamArea();
-});
-
-// Update credentials button when provider selector changes
-$("#upstream-provider-select").change(function () {
-    updateCredentialsButton();
-});
+// Display the intro box, unless the user has already dismissed it once.
+function displayIntroBox() {
+    if (localStorage.getItem("add-spot-intro-box-dismissed") == null) {
+        $("#add-spot-intro-box").show();
+    }
+    $("#add-spot-intro-box-dismiss").click(function () {
+        localStorage.setItem("add-spot-intro-box-dismissed", true);
+    });
+}
 
 // Startup
 $(document).ready(function () {
     // Load options
     loadOptions();
+    // Display intro box
+    displayIntroBox();
 });

static/js/alerts.js

@@ -8,7 +8,7 @@ let alerts = [];
 
 // Load alerts and populate the table.
 function loadAlerts() {
-    $.ajax({url: '/api/v2/alerts' + buildQueryString(), dataType: 'json', headers: getCredentialHeaders(), success: function (jsonData) {
+    $.getJSON('/api/v1/alerts' + buildQueryString(false), function (jsonData) {
         // Store last updated time
         lastUpdateTime = moment.utc();
         updateRefreshDisplay();
@@ -16,11 +16,11 @@ function loadAlerts() {
         alerts = jsonData;
         // Update table
         updateTable();
-    }});
+    });
 }
 
 // Build a query string for the API, based on the filters that the user has selected.
-function buildQueryString() {
+function buildQueryString(includeCredentials) {
     let str = "?";
     ["dx_continent", "source"].forEach(fn => {
         if (!allFilterOptionsSelected(fn)) {
@@ -35,6 +35,9 @@ function buildQueryString() {
     if ($("#dxpeditions_skip_max_duration_check")[0].checked) {
         str = str + "&dxpeditions_skip_max_duration_check=true";
     }
+    if (includeCredentials) {
+        str = str + getCredentialQueryString();
+    }
     return str;
 }
 
@@ -279,7 +282,7 @@ function addAlertRowsToTable(tbody, alerts) {
 
 // Load server options. Once a successful callback is made from this, we then query alerts.
 function loadOptions() {
-    $.getJSON('/api/v2/options', function (jsonData) {
+    $.getJSON('/api/v1/options', function (jsonData) {
         // Store options
         options = jsonData;
 

static/js/bands.js

@@ -20,7 +20,7 @@ function loadSpots() {
     if (evtSource != null) {
         evtSource.close();
     }
-    $.ajax({url: '/api/v2/spots' + buildQueryString(), dataType: 'json', headers: getCredentialHeaders(), success: function (jsonData) {
+    $.getJSON('/api/v1/spots' + buildQueryString(), function (jsonData) {
         // Store data
         spots = jsonData;
         // Update bands display
@@ -35,7 +35,7 @@ function startSSEConnection() {
     if (evtSource != null) {
         evtSource.close();
     }
-    evtSource = new EventSource('/api/v2/spots/stream' + buildQueryString());
+    evtSource = new EventSource('/api/v1/spots/stream' + buildQueryString());
 
     evtSource.onmessage = function (event) {
         const newSpot = JSON.parse(event.data);
@@ -273,7 +273,7 @@ function removeDuplicatesForBandPanel(spotList) {
 // Load server options. Once a successful callback is made from this, we then query spots and set up the timer to query
 // spots repeatedly.
 function loadOptions() {
-    $.getJSON('/api/v2/options', function (jsonData) {
+    $.getJSON('/api/v1/options', function (jsonData) {
         // Store options
         options = jsonData;
 

static/js/common.js

@@ -250,23 +250,23 @@ function closeDataPanel() {
     closePanel("#data-area");
 }
 
-// Build a headers object containing any QRZ.com / HamQTH credentials the user has supplied,
+// Build a query string fragment containing any QRZ.com / HamQTH credentials the user has supplied,
 // provided the corresponding "enabled" checkbox is ticked.
-function getCredentialHeaders() {
-    const headers = {};
+function getCredentialQueryString() {
+    let str = "";
     if ($("#qrz-enabled")[0] && $("#qrz-enabled")[0].checked) {
         const qrzUsername = $("#qrz-username").val();
         const qrzPassword = $("#qrz-password").val();
-        if (qrzUsername) headers["X-QRZ-Username"] = qrzUsername;
-        if (qrzPassword) headers["X-QRZ-Password"] = qrzPassword;
+        if (qrzUsername) str += "&qrz_username=" + encodeURIComponent(qrzUsername);
+        if (qrzPassword) str += "&qrz_password=" + encodeURIComponent(qrzPassword);
     }
     if ($("#hamqth-enabled")[0] && $("#hamqth-enabled")[0].checked) {
         const hamqthUsername = $("#hamqth-username").val();
         const hamqthPassword = $("#hamqth-password").val();
-        if (hamqthUsername) headers["X-HamQTH-Username"] = hamqthUsername;
-        if (hamqthPassword) headers["X-HamQTH-Password"] = hamqthPassword;
+        if (hamqthUsername) str += "&hamqth_username=" + encodeURIComponent(hamqthUsername);
+        if (hamqthPassword) str += "&hamqth_password=" + encodeURIComponent(hamqthPassword);
     }
-    return headers;
+    return str;
 }
 
 

static/js/conditions.js

@@ -10,7 +10,7 @@ let ionosondeChart = null;
 
 // Load solar conditions
 function loadSolarConditions() {
-    $.getJSON('/api/v2/solar', function (jsonData) {
+    $.getJSON('/api/v1/solar', function (jsonData) {
 
         // HF
 
@@ -539,7 +539,7 @@ function renderIonosondeData() {
             ctx.strokeStyle = gridColor;
             ctx.lineWidth = 1;
             ctx.setLineDash([]);
-            // Add an extra horizontal line for 30MHz, which should correspond to the top of the chart and avoid having
+            // Add an extra vertical line for 30MHz, which should correspond to the top of the chart and avoid having
             // no top "border" gridline
             const y30 = scales.y.getPixelForValue(30);
             if (y30 >= chartArea.top && y30 <= chartArea.bottom) {
@@ -660,7 +660,7 @@ function dxStatsContientChanged() {
 
 // Fetch DX stats from the API and render
 function loadDxStats() {
-    $.getJSON('/api/v2/dxstats', function (jsonData) {
+    $.getJSON('/api/v1/dxstats', function (jsonData) {
         dxStatsData = jsonData;
         renderDxStats();
     });

static/js/map.js

@@ -45,7 +45,7 @@ function loadSpots() {
     // 2) (If we have credentials) reload with them, replacing what's already there,
     // 3) Subscribe to the SSE endpoint (with credentials if we have them) so that updates come with augmented
     // data if they can.
-    $.ajax({url: '/api/v2/spots' + buildQueryString(), dataType: 'json', headers: getCredentialHeaders(), success: function (jsonData) {
+    $.getJSON('/api/v1/spots' + buildQueryString(false), function (jsonData) {
         // Store data
         spots = jsonData;
         // Update map
@@ -68,7 +68,7 @@ function loadSpots() {
             // now
             startSSEConnection();
         }
-    }});
+    });
 }
 
 // Start the SSE connection to receive new spots as they arrive
@@ -163,7 +163,7 @@ function removeSpotFromMap(key) {
 }
 
 // Build a query string for the API, based on the filters that the user has selected.
-function buildQueryString() {
+function buildQueryString(includeCredentials) {
     let str = "?";
     ["dx_continent", "de_continent", "mode", "source", "band", "sig"].forEach(fn => {
         if (!allFilterOptionsSelected(fn)) {
@@ -173,6 +173,9 @@ function buildQueryString() {
     str = str + "max_age=" + $("#max-spot-age option:selected").val();
     // Additional filters for the map view: No dupes, no QRT, only spots with good locations
     str = str + "&dedupe=true&allow_qrt=false";
+    if (includeCredentials) {
+        str = str + getCredentialQueryString();
+    }
     return str;
 }
 
@@ -301,7 +304,7 @@ function getTooltipText(s) {
 // Load server options. Once a successful callback is made from this, we then query spots and set up the timer to query
 // spots repeatedly.
 function loadOptions() {
-    $.getJSON('/api/v2/options', function (jsonData) {
+    $.getJSON('/api/v1/options', function (jsonData) {
         // Store options
         options = jsonData;
 

static/js/spots.js

@@ -20,7 +20,7 @@ function loadSpots() {
     }
 
     // Make the new query
-    $.ajax({url: '/api/v2/spots' + buildQueryString(), dataType: 'json', headers: getCredentialHeaders(), success: function (jsonData) {
+    $.getJSON('/api/v1/spots' + buildQueryString(false), function (jsonData) {
         // Store data
         spots = jsonData;
         // Update table
@@ -30,7 +30,7 @@ function loadSpots() {
         if (run) {
             startSSEConnection();
         }
-    }});
+    });
 }
 
 // Start an SSE connection (closing an existing one if it exists). This will then be used to add to the table on the
@@ -39,7 +39,7 @@ function startSSEConnection() {
     if (evtSource != null) {
         evtSource.close();
     }
-    evtSource = new EventSource('/api/v2/spots/stream' + buildQueryString());
+    evtSource = new EventSource('/api/v1/spots/stream' + buildQueryString(true));
 
     evtSource.onmessage = function (event) {
         // Get the new spot
@@ -86,7 +86,7 @@ function startSSEConnection() {
 }
 
 // Build a query string for the API, based on the filters that the user has selected.
-function buildQueryString() {
+function buildQueryString(includeCredentials) {
     let str = "?";
     ["dx_continent", "de_continent", "mode", "source", "band", "sig"].forEach(fn => {
         if (!allFilterOptionsSelected(fn)) {
@@ -97,6 +97,9 @@ function buildQueryString() {
     if ($("#search").val() !== "") {
         str = str + "&text_includes=" + encodeURIComponent($("#search").val());
     }
+    if (includeCredentials) {
+        str = str + getCredentialQueryString();
+    }
     return str;
 }
 
@@ -415,7 +418,7 @@ function createNewTableRowsForSpot(s, highlightNew) {
 // Load server options. Once a successful callback is made from this, we then query spots and set up the timer to query
 // spots repeatedly.
 function loadOptions() {
-    $.getJSON('/api/v2/options', function (jsonData) {
+    $.getJSON('/api/v1/options', function (jsonData) {
         // Store options
         options = jsonData;
 

static/js/status.js

@@ -1,6 +1,6 @@
 // Load server status
 function loadStatus() {
-    $.getJSON('/api/v2/status', function (jsonData) {
+    $.getJSON('/api/v1/status', function (jsonData) {
         $("#software-version").text(jsonData["software-version"]);
         $("#server-owner-callsign").text(jsonData["server-owner-callsign"]);
         $("#up-since").text(moment().subtract(jsonData["uptime"], 'seconds').fromNow());

static/js/ui-ham.js

@@ -296,16 +296,6 @@ function setBandColorScheme(scheme) {
     return ret;
 }
 
-// Get the list of known bands
-function getKnownBands() {
-    return Array.from(Object.keys(BAND_COLOR_SCHEMES[bandColorScheme]));
-}
-
-// Get the list of available band colour schemes
-function getAvailableBandColorSchemes() {
-    return Array.from(Object.keys(BAND_COLOR_SCHEMES));
-}
-
 // Band name to colour (in the current colour scheme). If the band is unknown, black will be returned.
 function bandToColor(band) {
     let col = (band != null) ? BAND_COLOR_SCHEMES[bandColorScheme][band] : null;
@@ -324,22 +314,6 @@ function bandToContrastColor(band) {
     return (lum > 128) ? "#000000" : "#ffffff";
 }
 
-const MODE_TYPE_COLOR_SCHEMES = {
-    "CW": "red",
-    "PHONE": "green",
-    "DATA": "blue"
-}
-
-// Mode type (CW, PHONE, DATA) to colour. If the mode type is unknown, black will be returned.
-function modeTypeToColor(modeType) {
-    let col = (modeType != null) ? MODE_TYPE_COLOR_SCHEMES[modeType.toUpperCase()] : null;
-    if (col) {
-        return col;
-    } else {
-        return "#000000";
-    }
-}
-
 const SIG_ICONS = {
     "POTA": "fa-tree",
     "SOTA": "fa-mountain-sun",
@@ -366,31 +340,6 @@ const SIG_ICONS = {
     "Toilets": "fa-toilet"
 }
 
-const SIG_NAMES = {
-    "POTA": "Parks on the Air",
-    "SOTA": "Summits on the Air",
-    "WWFF": "Worldwide Flora & Fauna",
-    "GMA": "Global Mountain Activity",
-    "WWBOTA": "Bunkers on the Air",
-    "HEMA": "Humps Excluding Marilyns Award",
-    "IOTA": "Islands on the Air",
-    "MOTA": "Mills on the Air",
-    "ARLHS": "Amateur Radio Lighthouse Society",
-    "ILLW": "International Lighthouse Lightship Weekend",
-    "SIOTA": "Silos on the Air",
-    "WCA": "World Castles Award",
-    "ZLOTA": "New Zealand on the Air",
-    "WOTA": "Wainwrights on the Air",
-    "BOTA": "Beaches on the Air",
-    "KRMNPA": "Keith Roget Memorial National Parks Award",
-    "LLOTA": "Lagos y Lagunas on the Air",
-    "WWTOTA": "Towers on the Air",
-    "WAB": "Worked All Britain",
-    "WAI": "Worked All Ireland",
-    "Tiles": "Tiles on the Air",
-    "TOTA": "Toilets on the Air"
-}
-
 // Get the Font Awesome icon for a given SIG. If the SIG is unknown, the provided default symbol will be returned
 function sigToIcon(sig, defaultIcon) {
     let col = (sig != null) ? SIG_ICONS[sig] : null;
@@ -405,35 +354,3 @@ function sigToIcon(sig, defaultIcon) {
         }
     }
 }
-
-// Get the full name for a given SIG abbreviation. If the SIG is unknown, an empty string will be returned.
-function sigToName(sig) {
-    let col = (sig != null) ? SIG_NAMES[sig] : null;
-    if (col) {
-        return col;
-    } else {
-        let col = (sig != null) ? SIG_NAMES[sig.toUpperCase()] : null;
-        if (col) {
-            return col;
-        } else {
-            return "";
-        }
-    }
-}
-
-// Get the list of known SIGs
-function getKnownSIGs() {
-    return Array.from(Object.keys(SIG_ICONS));
-}
-
-// Format a Maidenhead grid with alternating alphabetic blocks in lower case
-function formatGrid(grid) {
-    grid = grid.toUpperCase();
-    if (grid.length >= 6) {
-        grid = grid.substring(0, 4) + grid.substring(4, 6).toLowerCase() + grid.substring(6);
-    }
-    if (grid.length >= 12) {
-        grid = grid.substring(0, 10) + grid.substring(10, 12).toLowerCase() + grid.substring(14);
-    }
-    return grid;
-}

static/vendor/js/leaflet-workedallbritainireland.js

@@ -16,7 +16,7 @@ L.WorkedAllBritainIreland = L.LayerGroup.extend({
 
         // Workaround to load the geodesy modules in non-modular code. Once we have loaded all three modules, trigger a
         // first draw.
-        import("https://misc.ianrenton.com/Leaflet.WorkedAllBritainIreland/modules/geodesy/osgridref.js")
+        import(new URL('./modules/geodesy/osgridref.js', import.meta.url).href)
             .then(module => {
                 this._osGridLibrary = module;
                 if (this._ieGridLibrary && this._utmLibrary) {
@@ -27,7 +27,7 @@ L.WorkedAllBritainIreland = L.LayerGroup.extend({
                 console.log("Error loading OS Grid Ref library, GB WAB squares may not be available.");
                 console.log(error);
             });
-        import("https://misc.ianrenton.com/Leaflet.WorkedAllBritainIreland/modules/geodesy/iegridref.js")
+        import(new URL('./modules/geodesy/iegridref.js', import.meta.url).href)
             .then(module => {
                 this._ieGridLibrary = module;
                 if (this._osGridLibrary && this._utmLibrary) {
@@ -38,7 +38,7 @@ L.WorkedAllBritainIreland = L.LayerGroup.extend({
                 console.log("Error loading IE Grid Ref library, NI WAB squares may not be available.");
                 console.log(error);
             });
-        import("https://misc.ianrenton.com/Leaflet.WorkedAllBritainIreland/modules/geodesy/utm_ci.js")
+        import(new URL('./modules/geodesy/utm_ci.js', import.meta.url).href)
             .then(module => {
                 this._utmLibrary = module;
                 if (this._osGridLibrary && this._ieGridLibrary) {

static/vendor/js/modules/geodesy/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Chris Veness
+With some additional code & modifications by Ian Renton, 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

static/vendor/js/modules/geodesy/iegridref.js

@@ -0,0 +1,326 @@
+/* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+/* Ordnance Survey of Ireland Grid Reference funcs   (c) Chris Veness 2005-2021 & Ian Renton 2025 */
+/*                                                                                   MIT Licence  */
+/* www.movable-type.co.uk/scripts/latlong-gridref.html                                            */
+/* www.movable-type.co.uk/scripts/geodesy-library.html#IeGridRef                                  */
+/* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+
+import LatLonEllipsoidal, { Dms } from 'https://cdn.jsdelivr.net/npm/geodesy@2/latlon-ellipsoidal-datum.js';
+
+
+/**
+ * Ordnance Survey of Ireland & Northern Ireland grid reference calculations, based on the
+ * IeGridRef class in the geodesy library at https://github.com/chrisveness/geodesy
+ */
+
+/* IeGridRef  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
+
+
+const nationalGrid = {
+    trueOrigin:  { lat: 53.5, lon: -8 },                 // true origin of Irish grid 53°30′N, 8°W
+    falseOrigin: { easting: -200e3, northing: -250e3 }, // easting & northing of false origin, metres from true origin
+    scaleFactor: 1.000035,                         // scale factor on central meridian
+    ellipsoid:   LatLonEllipsoidal.ellipsoids.Airy1830,
+};
+
+/**
+ * Irish Grid References with methods to parse and convert them to latitude/longitude points.
+ */
+class IeGridRef {
+
+    /**
+     * Creates an IeGridRef object.
+     *
+     * @param {number} easting - Easting in metres from OS Grid false origin.
+     * @param {number} northing - Northing in metres from OS Grid false origin.
+     *
+     * @example
+     *   import IeGridRef from '/js/geodesy/IeGridRef.js';
+     *   const gridref = new IeGridRef(651409, 313177);
+     */
+    constructor(easting, northing) {
+        this.easting = Number(easting);
+        this.northing = Number(northing);
+
+        if (isNaN(easting)  || this.easting<0  || this.easting>7000e3) throw new RangeError(`invalid easting ‘${easting}’`);
+        if (isNaN(northing) || this.northing<0 || this.northing>13000e3) throw new RangeError(`invalid northing ‘${northing}’`);
+    }
+
+
+    /**
+     * Converts ‘this’ Irish Grid Reference easting/northing coordinate to latitude/longitude
+     * (SW corner of grid square).
+     *
+     * While OS Grid References are based on OSGB-36, the Ordnance Survey have deprecated the use of
+     * OSGB-36 for latitude/longitude coordinates (in favour of WGS-84), hence this function returns
+     * WGS-84 by default, with OSGB-36 as an option. See www.ordnancesurvey.co.uk/blog/2014/12/2.
+     *
+     * Note formulation implemented here due to Thomas, Redfearn, etc is as published by OS, but is
+     * inferior to Krüger as used by e.g. Karney 2011.
+     *
+     * @param   {LatLon.datum} [datum=WGS84] - Datum to convert grid reference into.
+     * @returns {LatLon}       Latitude/longitude of supplied grid reference.
+     *
+     * @example
+     *   const gridref = new IeGridRef(651409.903, 313177.270);
+     *   const pWgs84 = gridref.toLatLon();                    // 52°39′28.723″N, 001°42′57.787″E
+     *   // to obtain (historical) OSGB36 lat/lon point:
+     *   const pOsgb = gridref.toLatLon(LatLon.datums.OSGB36); // 52°39′27.253″N, 001°43′04.518″E
+     */
+    toLatLon(datum=LatLonEllipsoidal.datums.WGS84) {
+        const { easting: E, northing: N } = this;
+
+        const { a, b } = nationalGrid.ellipsoid;            // a = 6377563.396, b = 6356256.909
+        const φ0 = nationalGrid.trueOrigin.lat.toRadians(); // latitude of true origin
+        const λ0 = nationalGrid.trueOrigin.lon.toRadians(); // longitude of true origin
+        const E0 = -nationalGrid.falseOrigin.easting;       // easting of true origin
+        const N0 = -nationalGrid.falseOrigin.northing;      // northing of true origin
+        const F0 = nationalGrid.scaleFactor;                // scale factor
+
+        const e2 = 1 - (b*b)/(a*a);                         // eccentricity squared
+        const n = (a-b)/(a+b), n2 = n*n, n3 = n*n*n;        // n, n², n³
+
+        let φ=φ0, M=0;
+        do {
+            φ = (N-N0-M)/(a*F0) + φ;
+
+            const Ma = (1 + n + (5/4)*n2 + (5/4)*n3) * (φ-φ0);
+            const Mb = (3*n + 3*n2 + (21/8)*n3) * Math.sin(φ-φ0) * Math.cos(φ+φ0);
+            const Mc = ((15/8)*n2 + (15/8)*n3) * Math.sin(2*(φ-φ0)) * Math.cos(2*(φ+φ0));
+            const Md = (35/24)*n3 * Math.sin(3*(φ-φ0)) * Math.cos(3*(φ+φ0));
+            M = b * F0 * (Ma - Mb + Mc - Md);                // meridional arc
+
+        } while (Math.abs(N-N0-M) >= 0.00001);  // ie until < 0.01mm
+
+        const cosφ = Math.cos(φ), sinφ = Math.sin(φ);
+        const ν = a*F0/Math.sqrt(1-e2*sinφ*sinφ);            // nu = transverse radius of curvature
+        const ρ = a*F0*(1-e2)/Math.pow(1-e2*sinφ*sinφ, 1.5); // rho = meridional radius of curvature
+        const η2 = ν/ρ-1;                                    // eta = ?
+
+        const tanφ = Math.tan(φ);
+        const tan2φ = tanφ*tanφ, tan4φ = tan2φ*tan2φ, tan6φ = tan4φ*tan2φ;
+        const secφ = 1/cosφ;
+        const ν3 = ν*ν*ν, ν5 = ν3*ν*ν, ν7 = ν5*ν*ν;
+        const VII = tanφ/(2*ρ*ν);
+        const VIII = tanφ/(24*ρ*ν3)*(5+3*tan2φ+η2-9*tan2φ*η2);
+        const IX = tanφ/(720*ρ*ν5)*(61+90*tan2φ+45*tan4φ);
+        const X = secφ/ν;
+        const XI = secφ/(6*ν3)*(ν/ρ+2*tan2φ);
+        const XII = secφ/(120*ν5)*(5+28*tan2φ+24*tan4φ);
+        const XIIA = secφ/(5040*ν7)*(61+662*tan2φ+1320*tan4φ+720*tan6φ);
+
+        const dE = (E-E0), dE2 = dE*dE, dE3 = dE2*dE, dE4 = dE2*dE2, dE5 = dE3*dE2, dE6 = dE4*dE2, dE7 = dE5*dE2;
+        φ = φ - VII*dE2 + VIII*dE4 - IX*dE6;
+        const λ = λ0 + X*dE - XI*dE3 + XII*dE5 - XIIA*dE7;
+
+        let point = new LatLon_IeGridRef(φ.toDegrees(), λ.toDegrees(), 0, LatLonEllipsoidal.datums.OSGB36);
+
+        if (datum != LatLonEllipsoidal.datums.OSGB36) {
+            // if point is required in datum other than OSGB36, convert it
+            point = point.convertDatum(datum);
+            // convertDatum() gives us a LatLon: convert to LatLon_IeGridRef which includes toOsGrid()
+            point = new LatLon_IeGridRef(point.lat, point.lon, point.height, point.datum);
+        }
+
+        return point;
+    }
+
+
+    /**
+     * Parses grid reference to IeGridRef object.
+     *
+     * Accepts standard grid references (eg 'G 387 148'), with or without whitespace separators, from
+     * two-digit references up to 10-digit references (1m × 1m square), or fully numeric comma-separated
+     * references in metres (eg '438700,114800').
+     *
+     * @param   {string}    gridref - Standard format OS Grid Reference.
+     * @returns {IeGridRef} Numeric version of grid reference in metres from false origin (SW corner of
+     *   supplied grid square).
+     * @throws  {Error}     Invalid grid reference.
+     *
+     * @example
+     *   const grid = IeGridRef.parse('G 51409 13177'); // grid: { easting: 651409, northing: 313177 }
+     */
+    static parse(gridref) {
+        gridref = String(gridref).trim();
+
+        // check for fully numeric comma-separated gridref format
+        let match = gridref.match(/^(\d+),\s*(\d+)$/);
+        if (match) return new IeGridRef(match[1], match[2]);
+
+        // validate format
+        match = gridref.match(/^[ABCDEFGHJKLMNOPQRSTUVWXYZ]\s*[0-9]+\s*[0-9]+$/i);
+        if (!match) throw new Error(`invalid grid reference ‘${gridref}’`);
+
+        // get numeric values of letter references, mapping A->0, B->1, C->2, etc:
+        let l1 = gridref.toUpperCase().charCodeAt(0) - 'A'.charCodeAt(0); // 100km square
+        // shuffle down letters after 'I' since 'I' is not used in grid:
+        if (l1 > 7) l1--;
+
+        // convert grid letters into 100km-square indexes from false origin (grid square SV):
+        const e100km = l1 % 5;
+        const n100km = 4 - Math.floor(l1 / 5);
+
+        // skip grid letters to get numeric (easting/northing) part of ref
+        let en = gridref.slice(1).trim().split(/\s+/);
+        // if e/n not whitespace separated, split half way
+        if (en.length == 1) en = [ en[0].slice(0, en[0].length / 2), en[0].slice(en[0].length / 2) ];
+
+        // validation
+        if (en[0].length != en[1].length) throw new Error(`invalid grid reference ‘${gridref}’`);
+
+        // standardise to 10-digit refs (metres)
+        en[0] = en[0].padEnd(5, '0');
+        en[1] = en[1].padEnd(5, '0');
+
+        const e = e100km + en[0];
+        const n = n100km + en[1];
+
+        return new IeGridRef(e, n);
+    }
+
+
+    /**
+     * Converts ‘this’ numeric grid reference to standard OS of Ireland Grid Reference.
+     *
+     * @param   {number} [digits=10] - Precision of returned grid reference (10 digits = metres);
+     *   digits=0 will return grid reference in numeric format.
+     * @returns {string} This grid reference in standard format.
+     *
+     * @example
+     *   const gridref = new IeGridRef(651409, 313177).toString(8); // 'TG 5140 1317'
+     *   const gridref = new IeGridRef(651409, 313177).toString(0); // '651409,313177'
+     */
+    toString(digits=10) {
+        if (![ 0,2,4,6,8,10,12,14,16 ].includes(Number(digits))) throw new RangeError(`invalid precision ‘${digits}’`); // eslint-disable-line comma-spacing
+
+        let { easting: e, northing: n } = this;
+
+        // use digits = 0 to return numeric format (in metres) - note northing may be >= 1e7
+        if (digits == 0) {
+            const format = { useGrouping: false,  minimumIntegerDigits: 6, maximumFractionDigits: 3 };
+            const ePad = e.toLocaleString('en', format);
+            const nPad = n.toLocaleString('en', format);
+            return `${ePad},${nPad}`;
+        }
+
+        // get the 100km-grid indices
+        const e100km = Math.floor(e / 100000), n100km = Math.floor(n / 100000);
+
+        // translate those into the numeric equivalent of the grid letters
+        let l1 = (n100km) * 5 % 25 + e100km % 5;
+        return null; // haven't done this maths yet
+
+        // compensate for skipped 'I' and calculate grid letter
+        if (l1 > 7) l1++;
+        const letter = String.fromCharCode(l1 + 'A'.charCodeAt(0));
+
+        // strip 100km-grid indices from easting & northing, and reduce precision
+        e = Math.floor((e % 100000) / Math.pow(10, 5 - digits / 2));
+        n = Math.floor((n % 100000) / Math.pow(10, 5 - digits / 2));
+
+        // pad eastings & northings with leading zeros
+        e = e.toString().padStart(digits/2, '0');
+        n = n.toString().padStart(digits/2, '0');
+
+        return `${letter} ${e} ${n}`;
+    }
+
+}
+
+
+/* LatLon_IeGridRef - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
+
+
+/**
+ * Extends LatLon class with method to convert LatLon point to Irish Grid Reference.
+ *
+ * @extends LatLonEllipsoidal
+ */
+class LatLon_IeGridRef extends LatLonEllipsoidal {
+
+    /**
+     * Converts latitude/longitude to Ordnance Survey of Ireland grid reference easting/northing coordinate.
+     *
+     * @returns {IeGridRef} Irish Grid Reference easting/northing.
+     *
+     * @example
+     *   const grid = new LatLon(52.65798, 1.71605).toOsGrid(); // TG 51409 13177
+     *   // for conversion of (historical) OSGB36 latitude/longitude point:
+     *   const grid = new LatLon(52.65798, 1.71605).toOsGrid(LatLon.datums.OSGB36);
+     */
+    toOsGrid() {
+        // if necessary convert to OSGB36 first
+        const point = this.datum == LatLonEllipsoidal.datums.OSGB36
+            ? this
+            : this.convertDatum(LatLonEllipsoidal.datums.OSGB36);
+
+        const φ = point.lat.toRadians();
+        const λ = point.lon.toRadians();
+
+        const { a, b } = nationalGrid.ellipsoid;            // a = 6377563.396, b = 6356256.909
+        const φ0 = nationalGrid.trueOrigin.lat.toRadians(); // latitude of true origin
+        const λ0 = nationalGrid.trueOrigin.lon.toRadians(); // longitude of true origin
+        const E0 = -nationalGrid.falseOrigin.easting;       // easting of true origin
+        const N0 = -nationalGrid.falseOrigin.northing;      // northing of true origin
+        const F0 = nationalGrid.scaleFactor;                // scale factor
+
+        const e2 = 1 - (b*b)/(a*a);                          // eccentricity squared
+        const n = (a-b)/(a+b), n2 = n*n, n3 = n*n*n;         // n, n², n³
+
+        const cosφ = Math.cos(φ), sinφ = Math.sin(φ);
+        const ν = a*F0/Math.sqrt(1-e2*sinφ*sinφ);            // nu = transverse radius of curvature
+        const ρ = a*F0*(1-e2)/Math.pow(1-e2*sinφ*sinφ, 1.5); // rho = meridional radius of curvature
+        const η2 = ν/ρ-1;                                    // eta = ?
+
+        const Ma = (1 + n + (5/4)*n2 + (5/4)*n3) * (φ-φ0);
+        const Mb = (3*n + 3*n2 + (21/8)*n3) * Math.sin(φ-φ0) * Math.cos(φ+φ0);
+        const Mc = ((15/8)*n2 + (15/8)*n3) * Math.sin(2*(φ-φ0)) * Math.cos(2*(φ+φ0));
+        const Md = (35/24)*n3 * Math.sin(3*(φ-φ0)) * Math.cos(3*(φ+φ0));
+        const M = b * F0 * (Ma - Mb + Mc - Md);              // meridional arc
+
+        const cos3φ = cosφ*cosφ*cosφ;
+        const cos5φ = cos3φ*cosφ*cosφ;
+        const tan2φ = Math.tan(φ)*Math.tan(φ);
+        const tan4φ = tan2φ*tan2φ;
+
+        const I = M + N0;
+        const II = (ν/2)*sinφ*cosφ;
+        const III = (ν/24)*sinφ*cos3φ*(5-tan2φ+9*η2);
+        const IIIA = (ν/720)*sinφ*cos5φ*(61-58*tan2φ+tan4φ);
+        const IV = ν*cosφ;
+        const V = (ν/6)*cos3φ*(ν/ρ-tan2φ);
+        const VI = (ν/120) * cos5φ * (5 - 18*tan2φ + tan4φ + 14*η2 - 58*tan2φ*η2);
+
+        const Δλ = λ-λ0;
+        const Δλ2 = Δλ*Δλ, Δλ3 = Δλ2*Δλ, Δλ4 = Δλ3*Δλ, Δλ5 = Δλ4*Δλ, Δλ6 = Δλ5*Δλ;
+
+        let N = I + II*Δλ2 + III*Δλ4 + IIIA*Δλ6;
+        let E = E0 + IV*Δλ + V*Δλ3 + VI*Δλ5;
+
+        N = Number(N.toFixed(3)); // round to mm precision
+        E = Number(E.toFixed(3));
+
+        try {
+            return new IeGridRef(E, N); // note: gets truncated to SW corner of 1m grid square
+        } catch (e) {
+            throw new Error(`${e.message} from (${point.lat.toFixed(6)},${point.lon.toFixed(6)}).toOsGrid()`);
+        }
+    }
+
+
+    /**
+     * Override LatLonEllipsoidal.convertDatum() with version which returns LatLon_IeGridRef.
+     */
+    convertDatum(toDatum) {
+        const osieED = super.convertDatum(toDatum); // returns LatLonEllipsoidal_Datum
+        const osieOSGR = new LatLon_IeGridRef(osieED.lat, osieED.lon, osieED.height, osieED.datum);
+        return osieOSGR;
+    }
+
+}
+
+
+/* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+
+export { IeGridRef as default, LatLon_IeGridRef as LatLon, Dms };

static/vendor/js/modules/geodesy/osgridref.js

@@ -0,0 +1,348 @@
+/* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+/* Ordnance Survey Grid Reference functions                           (c) Chris Veness 2005-2021  */
+/*                                                                                   MIT Licence  */
+/* www.movable-type.co.uk/scripts/latlong-gridref.html                                            */
+/* www.movable-type.co.uk/scripts/geodesy-library.html#osgridref                                  */
+/* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+
+import LatLonEllipsoidal, { Dms } from 'https://cdn.jsdelivr.net/npm/geodesy@2/latlon-ellipsoidal-datum.js';
+
+
+/**
+ * Ordnance Survey OSGB grid references provide geocoordinate references for UK mapping purposes.
+ *
+ * Formulation implemented here due to Thomas, Redfearn, etc is as published by OS, but is inferior
+ * to Krüger as used by e.g. Karney 2011.
+ *
+ * www.ordnancesurvey.co.uk/documents/resources/guide-coordinate-systems-great-britain.pdf.
+ *
+ * Note OSGB grid references cover Great Britain only; Ireland and the Channel Islands have their
+ * own references.
+ *
+ * Note that these formulae are based on ellipsoidal calculations, and according to the OS are
+ * accurate to about 4–5 metres – for greater accuracy, a geoid-based transformation (OSTN15) must
+ * be used.
+ */
+
+/*
+ * Converted 2015 to work with WGS84 by default, OSGB36 as option;
+ * www.ordnancesurvey.co.uk/blog/2014/12/confirmation-on-changes-to-latitude-and-longitude
+ */
+
+
+/* OsGridRef  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
+
+
+const nationalGrid = {
+    trueOrigin:  { lat: 49, lon: -2 },                 // true origin of grid 49°N,2°W on OSGB36 datum
+    falseOrigin: { easting: -400e3, northing: 100e3 }, // easting & northing of false origin, metres from true origin
+    scaleFactor: 0.9996012717,                         // scale factor on central meridian
+    ellipsoid:   LatLonEllipsoidal.ellipsoids.Airy1830,
+};
+// note Irish National Grid uses t/o 53°30′N, 8°W, f/o 200kmW, 250kmS, scale factor 1.000035, on Airy 1830 Modified ellipsoid
+
+
+/**
+ * OS Grid References with methods to parse and convert them to latitude/longitude points.
+ */
+class OsGridRef {
+
+    /**
+     * Creates an OsGridRef object.
+     *
+     * @param {number} easting - Easting in metres from OS Grid false origin.
+     * @param {number} northing - Northing in metres from OS Grid false origin.
+     *
+     * @example
+     *   import OsGridRef from '/js/geodesy/osgridref.js';
+     *   const gridref = new OsGridRef(651409, 313177);
+     */
+    constructor(easting, northing) {
+        this.easting = Number(easting);
+        this.northing = Number(northing);
+
+        if (isNaN(easting)  || this.easting<0  || this.easting>700e3) throw new RangeError(`invalid easting ‘${easting}’`);
+        if (isNaN(northing) || this.northing<0 || this.northing>1300e3) throw new RangeError(`invalid northing ‘${northing}’`);
+    }
+
+
+    /**
+     * Converts ‘this’ Ordnance Survey Grid Reference easting/northing coordinate to latitude/longitude
+     * (SW corner of grid square).
+     *
+     * While OS Grid References are based on OSGB-36, the Ordnance Survey have deprecated the use of
+     * OSGB-36 for latitude/longitude coordinates (in favour of WGS-84), hence this function returns
+     * WGS-84 by default, with OSGB-36 as an option. See www.ordnancesurvey.co.uk/blog/2014/12/2.
+     *
+     * Note formulation implemented here due to Thomas, Redfearn, etc is as published by OS, but is
+     * inferior to Krüger as used by e.g. Karney 2011.
+     *
+     * @param   {LatLon.datum} [datum=WGS84] - Datum to convert grid reference into.
+     * @returns {LatLon}       Latitude/longitude of supplied grid reference.
+     *
+     * @example
+     *   const gridref = new OsGridRef(651409.903, 313177.270);
+     *   const pWgs84 = gridref.toLatLon();                    // 52°39′28.723″N, 001°42′57.787″E
+     *   // to obtain (historical) OSGB36 lat/lon point:
+     *   const pOsgb = gridref.toLatLon(LatLon.datums.OSGB36); // 52°39′27.253″N, 001°43′04.518″E
+     */
+    toLatLon(datum=LatLonEllipsoidal.datums.WGS84) {
+        const { easting: E, northing: N } = this;
+
+        const { a, b } = nationalGrid.ellipsoid;            // a = 6377563.396, b = 6356256.909
+        const φ0 = nationalGrid.trueOrigin.lat.toRadians(); // latitude of true origin, 49°N
+        const λ0 = nationalGrid.trueOrigin.lon.toRadians(); // longitude of true origin, 2°W
+        const E0 = -nationalGrid.falseOrigin.easting;       // easting of true origin, 400km
+        const N0 = -nationalGrid.falseOrigin.northing;      // northing of true origin, -100km
+        const F0 = nationalGrid.scaleFactor;                // 0.9996012717
+
+        const e2 = 1 - (b*b)/(a*a);                         // eccentricity squared
+        const n = (a-b)/(a+b), n2 = n*n, n3 = n*n*n;        // n, n², n³
+
+        let φ=φ0, M=0;
+        do {
+            φ = (N-N0-M)/(a*F0) + φ;
+
+            const Ma = (1 + n + (5/4)*n2 + (5/4)*n3) * (φ-φ0);
+            const Mb = (3*n + 3*n2 + (21/8)*n3) * Math.sin(φ-φ0) * Math.cos(φ+φ0);
+            const Mc = ((15/8)*n2 + (15/8)*n3) * Math.sin(2*(φ-φ0)) * Math.cos(2*(φ+φ0));
+            const Md = (35/24)*n3 * Math.sin(3*(φ-φ0)) * Math.cos(3*(φ+φ0));
+            M = b * F0 * (Ma - Mb + Mc - Md);                // meridional arc
+
+        } while (Math.abs(N-N0-M) >= 0.00001);  // ie until < 0.01mm
+
+        const cosφ = Math.cos(φ), sinφ = Math.sin(φ);
+        const ν = a*F0/Math.sqrt(1-e2*sinφ*sinφ);            // nu = transverse radius of curvature
+        const ρ = a*F0*(1-e2)/Math.pow(1-e2*sinφ*sinφ, 1.5); // rho = meridional radius of curvature
+        const η2 = ν/ρ-1;                                    // eta = ?
+
+        const tanφ = Math.tan(φ);
+        const tan2φ = tanφ*tanφ, tan4φ = tan2φ*tan2φ, tan6φ = tan4φ*tan2φ;
+        const secφ = 1/cosφ;
+        const ν3 = ν*ν*ν, ν5 = ν3*ν*ν, ν7 = ν5*ν*ν;
+        const VII = tanφ/(2*ρ*ν);
+        const VIII = tanφ/(24*ρ*ν3)*(5+3*tan2φ+η2-9*tan2φ*η2);
+        const IX = tanφ/(720*ρ*ν5)*(61+90*tan2φ+45*tan4φ);
+        const X = secφ/ν;
+        const XI = secφ/(6*ν3)*(ν/ρ+2*tan2φ);
+        const XII = secφ/(120*ν5)*(5+28*tan2φ+24*tan4φ);
+        const XIIA = secφ/(5040*ν7)*(61+662*tan2φ+1320*tan4φ+720*tan6φ);
+
+        const dE = (E-E0), dE2 = dE*dE, dE3 = dE2*dE, dE4 = dE2*dE2, dE5 = dE3*dE2, dE6 = dE4*dE2, dE7 = dE5*dE2;
+        φ = φ - VII*dE2 + VIII*dE4 - IX*dE6;
+        const λ = λ0 + X*dE - XI*dE3 + XII*dE5 - XIIA*dE7;
+
+        let point = new LatLon_OsGridRef(φ.toDegrees(), λ.toDegrees(), 0, LatLonEllipsoidal.datums.OSGB36);
+
+        if (datum != LatLonEllipsoidal.datums.OSGB36) {
+            // if point is required in datum other than OSGB36, convert it
+            point = point.convertDatum(datum);
+            // convertDatum() gives us a LatLon: convert to LatLon_OsGridRef which includes toOsGrid()
+            point = new LatLon_OsGridRef(point.lat, point.lon, point.height, point.datum);
+        }
+
+        return point;
+    }
+
+
+    /**
+     * Parses grid reference to OsGridRef object.
+     *
+     * Accepts standard grid references (eg 'SU 387 148'), with or without whitespace separators, from
+     * two-digit references up to 10-digit references (1m × 1m square), or fully numeric comma-separated
+     * references in metres (eg '438700,114800').
+     *
+     * @param   {string}    gridref - Standard format OS Grid Reference.
+     * @returns {OsGridRef} Numeric version of grid reference in metres from false origin (SW corner of
+     *   supplied grid square).
+     * @throws  {Error}     Invalid grid reference.
+     *
+     * @example
+     *   const grid = OsGridRef.parse('TG 51409 13177'); // grid: { easting: 651409, northing: 313177 }
+     */
+    static parse(gridref) {
+        gridref = String(gridref).trim();
+
+        // check for fully numeric comma-separated gridref format
+        let match = gridref.match(/^(\d+),\s*(\d+)$/);
+        if (match) return new OsGridRef(match[1], match[2]);
+
+        // validate format
+        match = gridref.match(/^[HNOST][ABCDEFGHJKLMNOPQRSTUVWXYZ]\s*[0-9]+\s*[0-9]+$/i);
+        if (!match) throw new Error(`invalid grid reference ‘${gridref}’`);
+
+        // get numeric values of letter references, mapping A->0, B->1, C->2, etc:
+        let l1 = gridref.toUpperCase().charCodeAt(0) - 'A'.charCodeAt(0); // 500km square
+        let l2 = gridref.toUpperCase().charCodeAt(1) - 'A'.charCodeAt(0); // 100km square
+        // shuffle down letters after 'I' since 'I' is not used in grid:
+        if (l1 > 7) l1--;
+        if (l2 > 7) l2--;
+
+        // convert grid letters into 100km-square indexes from false origin (grid square SV):
+        const e100km = ((l1 - 2) % 5) * 5 + (l2 % 5);
+        const n100km = (19 - Math.floor(l1 / 5) * 5) - Math.floor(l2 / 5);
+
+        // skip grid letters to get numeric (easting/northing) part of ref
+        let en = gridref.slice(2).trim().split(/\s+/);
+        // if e/n not whitespace separated, split half way
+        if (en.length == 1) en = [ en[0].slice(0, en[0].length / 2), en[0].slice(en[0].length / 2) ];
+
+        // validation
+        if (en[0].length != en[1].length) throw new Error(`invalid grid reference ‘${gridref}’`);
+
+        // standardise to 10-digit refs (metres)
+        en[0] = en[0].padEnd(5, '0');
+        en[1] = en[1].padEnd(5, '0');
+
+        const e = e100km + en[0];
+        const n = n100km + en[1];
+
+        return new OsGridRef(e, n);
+    }
+
+
+    /**
+     * Converts ‘this’ numeric grid reference to standard OS Grid Reference.
+     *
+     * @param   {number} [digits=10] - Precision of returned grid reference (10 digits = metres);
+     *   digits=0 will return grid reference in numeric format.
+     * @returns {string} This grid reference in standard format.
+     *
+     * @example
+     *   const gridref = new OsGridRef(651409, 313177).toString(8); // 'TG 5140 1317'
+     *   const gridref = new OsGridRef(651409, 313177).toString(0); // '651409,313177'
+     */
+    toString(digits=10) {
+        if (![ 0,2,4,6,8,10,12,14,16 ].includes(Number(digits))) throw new RangeError(`invalid precision ‘${digits}’`); // eslint-disable-line comma-spacing
+
+        let { easting: e, northing: n } = this;
+
+        // use digits = 0 to return numeric format (in metres) - note northing may be >= 1e7
+        if (digits == 0) {
+            const format = { useGrouping: false,  minimumIntegerDigits: 6, maximumFractionDigits: 3 };
+            const ePad = e.toLocaleString('en', format);
+            const nPad = n.toLocaleString('en', format);
+            return `${ePad},${nPad}`;
+        }
+
+        // get the 100km-grid indices
+        const e100km = Math.floor(e / 100000), n100km = Math.floor(n / 100000);
+
+        // translate those into numeric equivalents of the grid letters
+        let l1 = (19 - n100km) - (19 - n100km) % 5 + Math.floor((e100km + 10) / 5);
+        let l2 = (19 - n100km) * 5 % 25 + e100km % 5;
+
+        // compensate for skipped 'I' and build grid letter-pairs
+        if (l1 > 7) l1++;
+        if (l2 > 7) l2++;
+        const letterPair = String.fromCharCode(l1 + 'A'.charCodeAt(0), l2 + 'A'.charCodeAt(0));
+
+        // strip 100km-grid indices from easting & northing, and reduce precision
+        e = Math.floor((e % 100000) / Math.pow(10, 5 - digits / 2));
+        n = Math.floor((n % 100000) / Math.pow(10, 5 - digits / 2));
+
+        // pad eastings & northings with leading zeros
+        e = e.toString().padStart(digits/2, '0');
+        n = n.toString().padStart(digits/2, '0');
+
+        return `${letterPair} ${e} ${n}`;
+    }
+
+}
+
+
+/* LatLon_OsGridRef - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
+
+
+/**
+ * Extends LatLon class with method to convert LatLon point to OS Grid Reference.
+ *
+ * @extends LatLonEllipsoidal
+ */
+class LatLon_OsGridRef extends LatLonEllipsoidal {
+
+    /**
+     * Converts latitude/longitude to Ordnance Survey grid reference easting/northing coordinate.
+     *
+     * @returns {OsGridRef} OS Grid Reference easting/northing.
+     *
+     * @example
+     *   const grid = new LatLon(52.65798, 1.71605).toOsGrid(); // TG 51409 13177
+     *   // for conversion of (historical) OSGB36 latitude/longitude point:
+     *   const grid = new LatLon(52.65798, 1.71605).toOsGrid(LatLon.datums.OSGB36);
+     */
+    toOsGrid() {
+        // if necessary convert to OSGB36 first
+        const point = this.datum == LatLonEllipsoidal.datums.OSGB36
+            ? this
+            : this.convertDatum(LatLonEllipsoidal.datums.OSGB36);
+
+        const φ = point.lat.toRadians();
+        const λ = point.lon.toRadians();
+
+        const { a, b } = nationalGrid.ellipsoid;            // a = 6377563.396, b = 6356256.909
+        const φ0 = nationalGrid.trueOrigin.lat.toRadians(); // latitude of true origin, 49°N
+        const λ0 = nationalGrid.trueOrigin.lon.toRadians(); // longitude of true origin, 2°W
+        const E0 = -nationalGrid.falseOrigin.easting;       // easting of true origin, 400km
+        const N0 = -nationalGrid.falseOrigin.northing;      // northing of true origin, -100km
+        const F0 = nationalGrid.scaleFactor;                // 0.9996012717
+
+        const e2 = 1 - (b*b)/(a*a);                          // eccentricity squared
+        const n = (a-b)/(a+b), n2 = n*n, n3 = n*n*n;         // n, n², n³
+
+        const cosφ = Math.cos(φ), sinφ = Math.sin(φ);
+        const ν = a*F0/Math.sqrt(1-e2*sinφ*sinφ);            // nu = transverse radius of curvature
+        const ρ = a*F0*(1-e2)/Math.pow(1-e2*sinφ*sinφ, 1.5); // rho = meridional radius of curvature
+        const η2 = ν/ρ-1;                                    // eta = ?
+
+        const Ma = (1 + n + (5/4)*n2 + (5/4)*n3) * (φ-φ0);
+        const Mb = (3*n + 3*n2 + (21/8)*n3) * Math.sin(φ-φ0) * Math.cos(φ+φ0);
+        const Mc = ((15/8)*n2 + (15/8)*n3) * Math.sin(2*(φ-φ0)) * Math.cos(2*(φ+φ0));
+        const Md = (35/24)*n3 * Math.sin(3*(φ-φ0)) * Math.cos(3*(φ+φ0));
+        const M = b * F0 * (Ma - Mb + Mc - Md);              // meridional arc
+
+        const cos3φ = cosφ*cosφ*cosφ;
+        const cos5φ = cos3φ*cosφ*cosφ;
+        const tan2φ = Math.tan(φ)*Math.tan(φ);
+        const tan4φ = tan2φ*tan2φ;
+
+        const I = M + N0;
+        const II = (ν/2)*sinφ*cosφ;
+        const III = (ν/24)*sinφ*cos3φ*(5-tan2φ+9*η2);
+        const IIIA = (ν/720)*sinφ*cos5φ*(61-58*tan2φ+tan4φ);
+        const IV = ν*cosφ;
+        const V = (ν/6)*cos3φ*(ν/ρ-tan2φ);
+        const VI = (ν/120) * cos5φ * (5 - 18*tan2φ + tan4φ + 14*η2 - 58*tan2φ*η2);
+
+        const Δλ = λ-λ0;
+        const Δλ2 = Δλ*Δλ, Δλ3 = Δλ2*Δλ, Δλ4 = Δλ3*Δλ, Δλ5 = Δλ4*Δλ, Δλ6 = Δλ5*Δλ;
+
+        let N = I + II*Δλ2 + III*Δλ4 + IIIA*Δλ6;
+        let E = E0 + IV*Δλ + V*Δλ3 + VI*Δλ5;
+
+        N = Number(N.toFixed(3)); // round to mm precision
+        E = Number(E.toFixed(3));
+
+        try {
+            return new OsGridRef(E, N); // note: gets truncated to SW corner of 1m grid square
+        } catch (e) {
+            throw new Error(`${e.message} from (${point.lat.toFixed(6)},${point.lon.toFixed(6)}).toOsGrid()`);
+        }
+    }
+
+
+    /**
+     * Override LatLonEllipsoidal.convertDatum() with version which returns LatLon_OsGridRef.
+     */
+    convertDatum(toDatum) {
+        const osgbED = super.convertDatum(toDatum); // returns LatLonEllipsoidal_Datum
+        const osgbOSGR = new LatLon_OsGridRef(osgbED.lat, osgbED.lon, osgbED.height, osgbED.datum);
+        return osgbOSGR;
+    }
+
+}
+
+
+/* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+
+export { OsGridRef as default, LatLon_OsGridRef as LatLon, Dms };

static/vendor/js/modules/geodesy/utm_ci.js

@@ -0,0 +1,413 @@
+/* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+/* UTM / WGS-84 Conversion Functions                (c) Chris Veness 2014-2022 & Ian Renton 2025  */
+/*                                                                                   MIT Licence  */
+/* www.movable-type.co.uk/scripts/latlong-utm-mgrs.html                                           */
+/* www.movable-type.co.uk/scripts/geodesy-library.html#utm                                        */
+/* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+
+/* eslint-disable indent */
+
+import LatLonEllipsoidal, { Dms } from 'https://cdn.jsdelivr.net/npm/geodesy@2/latlon-ellipsoidal-datum.js';
+
+
+/**
+ * The Universal Transverse Mercator (UTM) system is a 2-dimensional Cartesian coordinate system
+ * providing locations on the surface of the Earth.
+ *
+ * UTM is a set of 60 transverse Mercator projections, normally based on the WGS-84 ellipsoid.
+ * Within each zone, coordinates are represented as eastings and northings, measures in metres; e.g.
+ * ‘31 N 448251 5411932’.
+ *
+ * This method based on Karney 2011 ‘Transverse Mercator with an accuracy of a few nanometers’,
+ * building on Krüger 1912 ‘Konforme Abbildung des Erdellipsoids in der Ebene’.
+ *
+ * @module utm
+ */
+
+
+/* Utm  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
+
+
+/**
+ * UTM coordinates, with functions to parse them and convert them to LatLon points.
+ */
+class Utm {
+
+    /**
+     * Creates a Utm coordinate object comprising zone, hemisphere, easting, northing on a given
+     * datum (normally WGS84).
+     *
+     * @param  {number}        zone - UTM 6° longitudinal zone (1..60 covering 180°W..180°E).
+     * @param  {string}        hemisphere - N for northern hemisphere, S for southern hemisphere.
+     * @param  {number}        easting - Easting in metres from false easting (-500km from central meridian).
+     * @param  {number}        northing - Northing in metres from equator (N) or from false northing -10,000km (S).
+     * @param  {LatLon.datums} [datum=WGS84] - Datum UTM coordinate is based on.
+     * @param  {number}        [convergence=null] - Meridian convergence (bearing of grid north
+     *                         clockwise from true north), in degrees.
+     * @param  {number}        [scale=null] - Grid scale factor.
+     * @params {boolean=true}  verifyEN - Check easting/northing is within 'normal' values (may be
+     *                         suppressed for extended coherent coordinates or alternative datums
+     *                         e.g. ED50 (epsg.io/23029).
+     * @throws {TypeError} Invalid UTM coordinate.
+     *
+     * @example
+     *   import Utm from '/js/geodesy/utm.js';
+     *   const utmCoord = new Utm(31, 'N', 448251, 5411932);
+     */
+    constructor(zone, hemisphere, easting, northing, datum=LatLonEllipsoidal.datums.WGS84, convergence=null, scale=null, verifyEN=true) {
+        if (!(1<=zone && zone<=60)) throw new RangeError(`invalid UTM zone ‘${zone}’`);
+        if (zone != parseInt(zone)) throw new RangeError(`invalid UTM zone ‘${zone}’`);
+        if (typeof hemisphere != 'string' || !hemisphere.match(/[NS]/i)) throw new RangeError(`invalid UTM hemisphere ‘${hemisphere}’`);
+        if (verifyEN) { // (rough) range-check of E/N values
+            if (!(0<=easting && easting<=1000e3)) throw new RangeError(`invalid UTM easting ‘${easting}’`);
+            if (hemisphere.toUpperCase()=='N' && !(0<=northing && northing<9329006)) throw new RangeError(`invalid UTM northing ‘${northing}’`);
+            if (hemisphere.toUpperCase()=='S' && !(1116914<northing && northing<=10000e3)) throw new RangeError(`invalid UTM northing ‘${northing}’`);
+        }
+        if (!datum || datum.ellipsoid==undefined) throw new TypeError(`unrecognised datum ‘${datum}’`);
+
+        this.zone = Number(zone);
+        this.hemisphere = hemisphere.toUpperCase();
+        this.easting = Number(easting);
+        this.northing = Number(northing);
+        this.datum = datum;
+        this.convergence = convergence===null ? null : Number(convergence);
+        this.scale = scale===null ? null : Number(scale);
+    }
+
+
+    /**
+     * Converts UTM zone/easting/northing coordinate to latitude/longitude.
+     *
+     * Implements Karney’s method, using Krüger series to order n⁶, giving results accurate to 5nm
+     * for distances up to 3900km from the central meridian.
+     *
+     * @param   {Utm} utmCoord - UTM coordinate to be converted to latitude/longitude.
+     * @returns {LatLon} Latitude/longitude of supplied grid reference.
+     *
+     * @example
+     *   const grid = new Utm(31, 'N', 448251.795, 5411932.678);
+     *   const latlong = grid.toLatLon(); // 48°51′29.52″N, 002°17′40.20″E
+     */
+    toLatLon() {
+        const { zone: z, hemisphere: h } = this;
+
+        const falseEasting = 500e3, falseNorthing = 10000e3;
+
+        const { a, f } = this.datum.ellipsoid; // WGS-84: a = 6378137, f = 1/298.257223563;
+
+        const k0 = 0.9996; // UTM scale on the central meridian
+
+        const x = this.easting - falseEasting;                            // make x ± relative to central meridian
+        const y = h=='S' ? this.northing - falseNorthing : this.northing; // make y ± relative to equator
+
+        // ---- from Karney 2011 Eq 15-22, 36:
+
+        const e = Math.sqrt(f*(2-f)); // eccentricity
+        const n = f / (2 - f);        // 3rd flattening
+        const n2 = n*n, n3 = n*n2, n4 = n*n3, n5 = n*n4, n6 = n*n5;
+
+        const A = a/(1+n) * (1 + 1/4*n2 + 1/64*n4 + 1/256*n6); // 2πA is the circumference of a meridian
+
+        const η = x / (k0*A);
+        const ξ = y / (k0*A);
+
+        const β = [ null, // note β is one-based array (6th order Krüger expressions)
+            1/2*n - 2/3*n2 + 37/96*n3 -    1/360*n4 -   81/512*n5 +    96199/604800*n6,
+                   1/48*n2 +  1/15*n3 - 437/1440*n4 +   46/105*n5 - 1118711/3870720*n6,
+                            17/480*n3 -   37/840*n4 - 209/4480*n5 +      5569/90720*n6,
+                                     4397/161280*n4 -   11/504*n5 -  830251/7257600*n6,
+                                                   4583/161280*n5 -  108847/3991680*n6,
+                                                                 20648693/638668800*n6 ];
+
+        let ξʹ = ξ;
+        for (let j=1; j<=6; j++) ξʹ -= β[j] * Math.sin(2*j*ξ) * Math.cosh(2*j*η);
+
+        let ηʹ = η;
+        for (let j=1; j<=6; j++) ηʹ -= β[j] * Math.cos(2*j*ξ) * Math.sinh(2*j*η);
+
+        const sinhηʹ = Math.sinh(ηʹ);
+        const sinξʹ = Math.sin(ξʹ), cosξʹ = Math.cos(ξʹ);
+
+        const τʹ = sinξʹ / Math.sqrt(sinhηʹ*sinhηʹ + cosξʹ*cosξʹ);
+
+        let δτi = null;
+        let τi = τʹ;
+        do {
+            const σi = Math.sinh(e*Math.atanh(e*τi/Math.sqrt(1+τi*τi)));
+            const τiʹ = τi * Math.sqrt(1+σi*σi) - σi * Math.sqrt(1+τi*τi);
+            δτi = (τʹ - τiʹ)/Math.sqrt(1+τiʹ*τiʹ)
+                * (1 + (1-e*e)*τi*τi) / ((1-e*e)*Math.sqrt(1+τi*τi));
+            τi += δτi;
+        } while (Math.abs(δτi) > 1e-12); // using IEEE 754 δτi -> 0 after 2-3 iterations
+        // note relatively large convergence test as δτi toggles on ±1.12e-16 for eg 31 N 400000 5000000
+        const τ = τi;
+
+        const φ = Math.atan(τ);
+
+        let λ = Math.atan2(sinhηʹ, cosξʹ);
+
+        // ---- convergence: Karney 2011 Eq 26, 27
+
+        let p = 1;
+        for (let j=1; j<=6; j++) p -= 2*j*β[j] * Math.cos(2*j*ξ) * Math.cosh(2*j*η);
+        let q = 0;
+        for (let j=1; j<=6; j++) q += 2*j*β[j] * Math.sin(2*j*ξ) * Math.sinh(2*j*η);
+
+        const γʹ = Math.atan(Math.tan(ξʹ) * Math.tanh(ηʹ));
+        const γʺ = Math.atan2(q, p);
+
+        const γ = γʹ + γʺ;
+
+        // ---- scale: Karney 2011 Eq 28
+
+        const sinφ = Math.sin(φ);
+        const kʹ = Math.sqrt(1 - e*e*sinφ*sinφ) * Math.sqrt(1 + τ*τ) * Math.sqrt(sinhηʹ*sinhηʹ + cosξʹ*cosξʹ);
+        const kʺ = A / a / Math.sqrt(p*p + q*q);
+
+        const k = k0 * kʹ * kʺ;
+
+        // ------------
+
+        const λ0 = ((z-1)*6 - 180 + 3).toRadians(); // longitude of central meridian
+        λ += λ0; // move λ from zonal to global coordinates
+
+        // round to reasonable precision
+        const lat = Number(φ.toDegrees().toFixed(14)); // nm precision (1nm = 10^-14°)
+        const lon = Number(λ.toDegrees().toFixed(14)); // (strictly lat rounding should be φ⋅cosφ!)
+        const convergence = Number(γ.toDegrees().toFixed(9));
+        const scale = Number(k.toFixed(12));
+
+        const latLong = new LatLon_Utm(lat, lon, 0, this.datum);
+        // ... and add the convergence and scale into the LatLon object ... wonderful JavaScript!
+        latLong.convergence = convergence;
+        latLong.scale = scale;
+
+        return latLong;
+    }
+
+    /**
+     * Parses a Channel Islands (WA/WV) grid reference.
+     */
+    static parseChannelIslandGrid(gridref) {
+        // validate format
+        let match = gridref.match(/^W[AV]\s*[0-9]+\s*[0-9]+$/i);
+        if (!match) throw new Error(`invalid grid reference ‘${gridref}’`);
+
+        // skip grid letters to get numeric (easting/northing) part of ref
+        let en = gridref.slice(2).trim().split(/\s+/);
+        // if e/n not whitespace separated, split half way
+        if (en.length == 1) en = [ en[0].slice(0, en[0].length / 2), en[0].slice(en[0].length / 2) ];
+
+        // validation
+        if (en[0].length != en[1].length) throw new Error(`invalid grid reference ‘${gridref}’`);
+
+        // standardise to 10-digit refs (metres)
+        en[0] = en[0].padEnd(5, '0');
+        en[1] = en[1].padEnd(5, '0');
+
+        let utmCoord = "30 N ";
+        const e = 5 + en[0];
+        utmCoord += e + " ";
+        if (gridref.substring(0, 2) === "WA") {
+            const n = 55 + en[1];
+            utmCoord += n;
+        } else if (gridref.substring(0, 2) === "WV") {
+            const n = 54 + en[1];
+            utmCoord += n;
+        }
+
+        return Utm.parse(utmCoord);
+    }
+
+
+    /**
+     * Parses string representation of UTM coordinate.
+     *
+     * A UTM coordinate comprises (space-separated)
+     *  - zone
+     *  - hemisphere
+     *  - easting
+     *  - northing.
+     *
+     * @param   {string} utmCoord - UTM coordinate (WGS 84).
+     * @param   {Datum}  [datum=WGS84] - Datum coordinate is defined in (default WGS 84).
+     * @returns {Utm} Parsed UTM coordinate.
+     * @throws  {TypeError} Invalid UTM coordinate.
+     *
+     * @example
+     *   const utmCoord = Utm.parse('31 N 448251 5411932');
+     *   // utmCoord: {zone: 31, hemisphere: 'N', easting: 448251, northing: 5411932 }
+     */
+    static parse(utmCoord, datum=LatLonEllipsoidal.datums.WGS84) {
+        // match separate elements (separated by whitespace)
+        utmCoord = utmCoord.trim().match(/\S+/g);
+
+        if (utmCoord==null || utmCoord.length!=4) throw new Error(`invalid UTM coordinate ‘${utmCoord}’`);
+
+        const zone = utmCoord[0], hemisphere = utmCoord[1], easting = utmCoord[2], northing = utmCoord[3];
+
+        return new this(zone, hemisphere, easting, northing, datum); // 'new this' as may return subclassed types
+    }
+
+
+    /**
+     * Returns a string representation of a UTM coordinate.
+     *
+     * To distinguish from MGRS grid zone designators, a space is left between the zone and the
+     * hemisphere.
+     *
+     * Note that UTM coordinates get rounded, not truncated (unlike MGRS grid references).
+     *
+     * @param   {number} [digits=0] - Number of digits to appear after the decimal point (3 ≡ mm).
+     * @returns {string} A string representation of the coordinate.
+     *
+     * @example
+     *   const utm = new Utm('31', 'N', 448251, 5411932).toString(4);  // 31 N 448251.0000 5411932.0000
+     */
+    toString(digits=0) {
+
+        const z = this.zone.toString().padStart(2, '0');
+        const h = this.hemisphere;
+        const e = this.easting.toFixed(digits);
+        const n = this.northing.toFixed(digits);
+
+        return `${z} ${h} ${e} ${n}`;
+    }
+
+}
+
+
+/* LatLon_Utm - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
+
+
+/**
+ * Extends LatLon with method to convert LatLon points to UTM coordinates.
+ *
+ * @extends LatLon
+ */
+class LatLon_Utm extends LatLonEllipsoidal {
+
+    /**
+     * Converts latitude/longitude to UTM coordinate.
+     *
+     * Implements Karney’s method, using Krüger series to order n⁶, giving results accurate to 5nm
+     * for distances up to 3900km from the central meridian.
+     *
+     * @param   {number} [zoneOverride] - Use specified zone rather than zone within which point lies;
+     *          note overriding the UTM zone has the potential to result in negative eastings, and
+     *          perverse results within Norway/Svalbard exceptions.
+     * @returns {Utm} UTM coordinate.
+     * @throws  {TypeError} Latitude outside UTM limits.
+     *
+     * @example
+     *   const latlong = new LatLon(48.8582, 2.2945);
+     *   const utmCoord = latlong.toUtm(); // 31 N 448252 5411933
+     */
+    toUtm(zoneOverride=undefined) {
+        if (!(-80<=this.lat && this.lat<=84)) throw new RangeError(`latitude ‘${this.lat}’ outside UTM limits`);
+
+        const falseEasting = 500e3, falseNorthing = 10000e3;
+
+        let zone = zoneOverride || Math.floor((this.lon+180)/6) + 1; // longitudinal zone
+        let λ0 = ((zone-1)*6 - 180 + 3).toRadians(); // longitude of central meridian
+
+        // ---- handle Norway/Svalbard exceptions
+        // grid zones are 8° tall; 0°N is offset 10 into latitude bands array
+        const mgrsLatBands = 'CDEFGHJKLMNPQRSTUVWXX'; // X is repeated for 80-84°N
+        const latBand = mgrsLatBands.charAt(Math.floor(this.lat/8+10));
+        // adjust zone & central meridian for Norway
+        if (zone==31 && latBand=='V' && this.lon>= 3) { zone++; λ0 += (6).toRadians(); }
+        // adjust zone & central meridian for Svalbard
+        if (zone==32 && latBand=='X' && this.lon<  9) { zone--; λ0 -= (6).toRadians(); }
+        if (zone==32 && latBand=='X' && this.lon>= 9) { zone++; λ0 += (6).toRadians(); }
+        if (zone==34 && latBand=='X' && this.lon< 21) { zone--; λ0 -= (6).toRadians(); }
+        if (zone==34 && latBand=='X' && this.lon>=21) { zone++; λ0 += (6).toRadians(); }
+        if (zone==36 && latBand=='X' && this.lon< 33) { zone--; λ0 -= (6).toRadians(); }
+        if (zone==36 && latBand=='X' && this.lon>=33) { zone++; λ0 += (6).toRadians(); }
+
+        const φ = this.lat.toRadians();      // latitude ± from equator
+        const λ = this.lon.toRadians() - λ0; // longitude ± from central meridian
+
+        // allow alternative ellipsoid to be specified
+        const ellipsoid = this.datum ? this.datum.ellipsoid : LatLonEllipsoidal.ellipsoids.WGS84;
+        const { a, f } = ellipsoid; // WGS-84: a = 6378137, f = 1/298.257223563;
+
+        const k0 = 0.9996; // UTM scale on the central meridian
+
+        // ---- easting, northing: Karney 2011 Eq 7-14, 29, 35:
+
+        const e = Math.sqrt(f*(2-f)); // eccentricity
+        const n = f / (2 - f);        // 3rd flattening
+        const n2 = n*n, n3 = n*n2, n4 = n*n3, n5 = n*n4, n6 = n*n5;
+
+        const cosλ = Math.cos(λ), sinλ = Math.sin(λ), tanλ = Math.tan(λ);
+
+        const τ = Math.tan(φ); // τ ≡ tanφ, τʹ ≡ tanφʹ; prime (ʹ) indicates angles on the conformal sphere
+        const σ = Math.sinh(e*Math.atanh(e*τ/Math.sqrt(1+τ*τ)));
+
+        const τʹ = τ*Math.sqrt(1+σ*σ) - σ*Math.sqrt(1+τ*τ);
+
+        const ξʹ = Math.atan2(τʹ, cosλ);
+        const ηʹ = Math.asinh(sinλ / Math.sqrt(τʹ*τʹ + cosλ*cosλ));
+
+        const A = a/(1+n) * (1 + 1/4*n2 + 1/64*n4 + 1/256*n6); // 2πA is the circumference of a meridian
+
+        const α = [ null, // note α is one-based array (6th order Krüger expressions)
+            1/2*n - 2/3*n2 + 5/16*n3 +   41/180*n4 -     127/288*n5 +      7891/37800*n6,
+                  13/48*n2 -  3/5*n3 + 557/1440*n4 +     281/630*n5 - 1983433/1935360*n6,
+                           61/240*n3 -  103/140*n4 + 15061/26880*n5 +   167603/181440*n6,
+                                   49561/161280*n4 -     179/168*n5 + 6601661/7257600*n6,
+                                                     34729/80640*n5 - 3418889/1995840*n6,
+                                                                  212378941/319334400*n6 ];
+
+        let ξ = ξʹ;
+        for (let j=1; j<=6; j++) ξ += α[j] * Math.sin(2*j*ξʹ) * Math.cosh(2*j*ηʹ);
+
+        let η = ηʹ;
+        for (let j=1; j<=6; j++) η += α[j] * Math.cos(2*j*ξʹ) * Math.sinh(2*j*ηʹ);
+
+        let x = k0 * A * η;
+        let y = k0 * A * ξ;
+
+        // ---- convergence: Karney 2011 Eq 23, 24
+
+        let pʹ = 1;
+        for (let j=1; j<=6; j++) pʹ += 2*j*α[j] * Math.cos(2*j*ξʹ) * Math.cosh(2*j*ηʹ);
+        let qʹ = 0;
+        for (let j=1; j<=6; j++) qʹ += 2*j*α[j] * Math.sin(2*j*ξʹ) * Math.sinh(2*j*ηʹ);
+
+        const γʹ = Math.atan(τʹ / Math.sqrt(1+τʹ*τʹ)*tanλ);
+        const γʺ = Math.atan2(qʹ, pʹ);
+
+        const γ = γʹ + γʺ;
+
+        // ---- scale: Karney 2011 Eq 25
+
+        const sinφ = Math.sin(φ);
+        const kʹ = Math.sqrt(1 - e*e*sinφ*sinφ) * Math.sqrt(1 + τ*τ) / Math.sqrt(τʹ*τʹ + cosλ*cosλ);
+        const kʺ = A / a * Math.sqrt(pʹ*pʹ + qʹ*qʹ);
+
+        const k = k0 * kʹ * kʺ;
+
+        // ------------
+
+        // shift x/y to false origins
+        x = x + falseEasting;             // make x relative to false easting
+        if (y < 0) y = y + falseNorthing; // make y in southern hemisphere relative to false northing
+
+        // round to reasonable precision
+        x = Number(x.toFixed(9)); // nm precision
+        y = Number(y.toFixed(9)); // nm precision
+        const convergence = Number(γ.toDegrees().toFixed(9));
+        const scale = Number(k.toFixed(12));
+
+        const h = this.lat>=0 ? 'N' : 'S'; // hemisphere
+
+        return new Utm(zone, h, x, y, this.datum, convergence, scale, !!zoneOverride);
+    }
+}
+
+
+/* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+
+export { Utm as default, LatLon_Utm as LatLon, Dms };

templates/about.html

@@ -117,7 +117,6 @@
         <li>Some SIGs, such as Worked all Britain (WAB), don't have their own spotting site and can <em>only</em> be
             identified through comments on spots retrieved from other sources.
         </li>
-        <li>SIGs have well-defined names, whereas the server owner may name the sources as they see fit.</li>
     </ol>
     <p>Spothole's web interface exists not just for the end user, but also as a reference implementation for the API, so
         I have chosen to demonstrate both methods of filtering.</p>

templates/add_spot.html

@@ -24,14 +24,14 @@
             </div>
         </div>
         <div class="card-body">
-            <form class="row g-3" onsubmit="return addSpot();">
+            <form class="row g-3">
                 <div class="col-auto">
                     <label for="dx-call" class="form-label">DX Call *</label>
-                    <input type="text" class="form-control input-narrow" id="dx-call" placeholder="N0CALL" required>
+                    <input type="text" class="form-control input-narrow" id="dx-call" placeholder="N0CALL">
                 </div>
                 <div class="col-auto">
                     <label for="freq" class="form-label">Frequency (kHz) *</label>
-                    <input type="text" class="form-control input-narrow" id="freq" placeholder="e.g. 14100" required>
+                    <input type="text" class="form-control input-narrow" id="freq" placeholder="e.g. 14100">
                 </div>
                 <div class="col-auto">
                     <label for="mode" class="form-label">Mode</label>
@@ -60,10 +60,10 @@
                 <div class="col-auto">
                     <label for="de-call" class="form-label">Your Call *</label>
                     <input type="text" class="form-control storeable-text input-narrow" id="de-call"
-                           placeholder="N0CALL" required>
+                           placeholder="N0CALL">
                 </div>
                 <div class="col-auto">
-                    <button type="submit" class="btn btn-primary mt-2em">Spot</button>
+                    <button type="button" class="btn btn-primary mt-2em" onclick="addSpot();">Spot</button>
                 </div>
             </form>
 
@@ -76,7 +76,7 @@
 
 </div>
 
-<script src="/static/js/add-spot.js?v=1785082221"></script>
+<script src="/static/js/add-spot.js?v=1786081935"></script>
 <script>$(document).ready(function () {
     $("#nav-link-add-spot").addClass("active");
 }); <!-- highlight active page in nav --></script>

templates/alerts.html

@@ -75,7 +75,7 @@
 
 </div>
 
-<script src="/static/js/alerts.js?v=1785082221"></script>
+<script src="/static/js/alerts.js?v=1786081935"></script>
 <script>$(document).ready(function () {
     $("#nav-link-alerts").addClass("active");
 }); <!-- highlight active page in nav --></script>

templates/bands.html

@@ -75,8 +75,8 @@
 <script>
     let spotProvidersEnabledByDefault = {% raw json_encode(web_ui_options["spot-providers-enabled-by-default"]) %};
 </script>
-<script src="/static/js/spotsbandsandmap.js?v=1785082221"></script>
-<script src="/static/js/bands.js?v=1785082221"></script>
+<script src="/static/js/spotsbandsandmap.js?v=1786081935"></script>
+<script src="/static/js/bands.js?v=1786081935"></script>
 <script>$(document).ready(function () {
     $("#nav-link-bands").addClass("active");
 }); <!-- highlight active page in nav --></script>

templates/base.html

@@ -1,6 +1,6 @@
 {% extends "skeleton.html" %}
 {% block head_extra %}
-<link rel="stylesheet" href="/static/css/style.css?v=1785082221" type="text/css">
+<link rel="stylesheet" href="/static/css/style.css?v=1786081935" type="text/css">
 <link href="/static/vendor/css/bootstrap-5.3.8.min.css" rel="stylesheet">
 <link href="/static/vendor/css/fontawesome-6.7.2.min.css" rel="stylesheet">
 <link href="/static/vendor/css/solid-6.7.2.min.css" rel="stylesheet">
@@ -10,10 +10,10 @@
 <script src="/static/vendor/js/bootstrap-5.3.8.bundle.min.js"></script>
 <script src="/static/vendor/js/tinycolor2-1.6.0.min.js"></script>
 
-<script src="/static/js/utils.js?v=1785082221"></script>
-<script src="/static/js/ui-ham.js?v=1785082221"></script>
-<script src="/static/js/geo.js?v=1785082221"></script>
-<script src="/static/js/common.js?v=1785082221"></script>
+<script src="/static/js/utils.js?v=1786081935"></script>
+<script src="/static/js/ui-ham.js?v=1786081935"></script>
+<script src="/static/js/geo.js?v=1786081935"></script>
+<script src="/static/js/common.js?v=1786081935"></script>
 {% end %}
 {% block body %}
 <div class="container">

templates/conditions.html

@@ -284,7 +284,7 @@
 </div>
 
 <script src="/static/vendor/js/chart-4.4.9.umd.min.js"></script>
-<script src="/static/js/conditions.js?v=1785082221"></script>
+<script src="/static/js/conditions.js?v=1786081935"></script>
 <script>$(document).ready(function () {
     $("#nav-link-conditions").addClass("active");
 }); <!-- highlight active page in nav --></script>

templates/map.html

@@ -108,8 +108,8 @@
 <script>
     let spotProvidersEnabledByDefault = {% raw json_encode(web_ui_options["spot-providers-enabled-by-default"]) %};
 </script>
-<script src="/static/js/spotsbandsandmap.js?v=1785082221"></script>
-<script src="/static/js/map.js?v=1785082221"></script>
+<script src="/static/js/spotsbandsandmap.js?v=1786081935"></script>
+<script src="/static/js/map.js?v=1786081935"></script>
 <script>$(document).ready(function () {
     $("#nav-link-map").addClass("active");
 }); <!-- highlight active page in nav --></script>

templates/spots.html

@@ -116,8 +116,8 @@
 <script>
     let spotProvidersEnabledByDefault = {% raw json_encode(web_ui_options["spot-providers-enabled-by-default"]) %};
 </script>
-<script src="/static/js/spotsbandsandmap.js?v=1785082221"></script>
-<script src="/static/js/spots.js?v=1785082221"></script>
+<script src="/static/js/spotsbandsandmap.js?v=1786081935"></script>
+<script src="/static/js/spots.js?v=1786081935"></script>
 <script>$(document).ready(function () {
     $("#nav-link-spots").addClass("active");
 }); <!-- highlight active page in nav --></script>

templates/status.html

@@ -59,7 +59,7 @@
     </div>
 </div>
 
-<script src="/static/js/status.js?v=1785082221"></script>
+<script src="/static/js/status.js?v=1786081935"></script>
 <script>
     $(document).ready(function () {
         $("#nav-link-status").addClass("active");