← Back to updater

Documentation

POTA → OSM Updater

A review-first workflow for reconciling active POTA parks with OpenStreetMap amateur radio entities.

How it works

  1. Pan and zoom the Leaflet map to the area you want to review.
  2. The map loads active POTA CSV points and uses Overpass to remove references already tagged in OSM.
  3. The visible map must cover no more than 20,000 km². Confirm the view with Find candidates in the displayed map.
  4. Search public OSM Photon results first, falling back to Nominatim when needed, with partial and fuzzy matching that prioritizes ways and relations.
  5. Inspect candidates in OSM, then approve at most one candidate per POTA park.
  6. Download an OsmChange file containing only approved modifications.

Authentication

OpenStreetMap is the only identity provider. Connect an OSM account through OAuth 2.0 Authorization Code with PKCE; the app requests read_prefs and write_api, keeps the token in an HttpOnly cookie, and adds Secure automatically for HTTPS deployments. The complete registration guide is in docs/osm-oauth-setup.md in the repository.

Safeguards

The app never uploads changes automatically from the review queue. After approval, choose direct upload or inspect the generated file in JOSM first.

PlantUML diagrams

The source diagrams are in the docs directory: architecture and reconciliation sequence. They use only core PlantUML syntax so they render on plantuml.com.