openworld_radio_twin.providers.uke#

The UKE lists of radio permits for mobile base stations, Poland.

The Office of Electronic Communications (UKE) publishes every month, on dane.gov.pl under CC BY 4.0, one spreadsheet per system and band (“LTE1800”, “5G3600”, …) listing the permitted base stations with their operator, station identifier and position. The lists give no height, direction, power or frequency block, only the band. The adapter joins the rows of one operator, station and position into one antenna with all its bands; each band is registered as its whole 3GPP downlink range, so the operators on a band share one channel. Lists of other services (GSM-R, CDMA and LTE at 420/450 MHz) are skipped. A permit does not guarantee that the station is built, and the lists name few Plus (Polkomtel) stations.

The newest monthly archive is found through the dane.gov.pl API, downloaded once and converted to a local point index pinned by its date and SHA-256.

Functions

antenna_records(table, release)

latest_export(client)

Date and URL of the newest monthly archive.

read_export(path)

One row per operator, station and position, with its bands.

sheet_rows(content)

The rows of a list's first sheet, keyed by the header row.

snapshot_directory(settings)

Classes

UkeProvider(settings, client)

openworld_radio_twin.providers.uke.snapshot_directory(settings)[source]#
Return type:

Path

openworld_radio_twin.providers.uke.sheet_rows(content)[source]#

The rows of a list’s first sheet, keyed by the header row.

Return type:

list[dict[str, str]]

openworld_radio_twin.providers.uke.read_export(path)[source]#

One row per operator, station and position, with its bands.

Return type:

tuple[Table, dict[str, object]]

openworld_radio_twin.providers.uke.antenna_records(table, release)[source]#
Return type:

list[AntennaFeature]

async openworld_radio_twin.providers.uke.latest_export(client)[source]#

Date and URL of the newest monthly archive.

Return type:

tuple[str, str]

class openworld_radio_twin.providers.uke.UkeProvider(settings, client)[source]#

Bases: object

async snapshot(*, refresh=False)[source]#

The installed snapshot; downloads the newest archive first when none is installed.

Return type:

Snapshot

async antennas(latitude, longitude, radius_m)[source]#
Return type:

AntennaQueryResult