openworld_radio_twin.providers.registry#
Trusted, installed data sources shared by library, batch and HTTP APIs.
One registry type serves every kind of source (buildings, antennas). A source is an adapter with an identifier, a version, a coverage predicate and attribution. Requests select a source explicitly or by location; installed packages add sources through the entry-point group of their kind.
Functions
|
Coverage test for the packaged boundary |
|
Resolve a source before acquisition; explicit selections never fall back silently. |
|
Classes
|
|
|
|
alias of |
|
|
|
|
Provider identity and factory; auto-selection is explicitly opt-in. |
|
Installed sources of one kind; subclasses name the kind and its entry-point group. |
- class openworld_radio_twin.providers.registry.BuildingProvider(*args, **kwargs)[source]#
Bases:
Protocol
- openworld_radio_twin.providers.registry.region(name)[source]#
Coverage test for the packaged boundary
providers/data/<name>.geojson.The file’s provenance is recorded in
providers/data/README.md.
- class openworld_radio_twin.providers.registry.DataSource(identifier, title, version, factory, covers=<function worldwide>, auto_priority=None, attribution='', license_url='', configuration_identity=None, auto_covers=None, configured=None, configuration_hint='', license='')[source]#
Bases:
objectProvider identity and factory; auto-selection is explicitly opt-in.
covers(latitude, longitude)restricts explicit and automatic selection;auto_coversrestricts only automatic selection. Usecoverswhen the provider cannot tell that a query lies outside its data, such as a live query or a snapshot, andauto_coverswhen the provider checks its own tile index and can serve explicit requests beyond the routing boundary. Higherauto_prioritywins; None leaves a source available only by explicit selection. Version changes must accompany changes in source interpretation or geometry reconstruction.configuredreports whether the settings supply what the source needs, such as a token or a local file; automatic routing skips a source that is not configured, andconfiguration_hinttells the user how to configure it.
- openworld_radio_twin.providers.registry.BuildingSource#
alias of
DataSource
- class openworld_radio_twin.providers.registry.SourceRegistry(sources=())[source]#
Bases:
objectInstalled sources of one kind; subclasses name the kind and its entry-point group.
- load_installed()[source]#
Load explicitly installed entry points, never a request-supplied import path.
- Return type:
- class openworld_radio_twin.providers.registry.BuildingSourceRegistry(sources=())[source]#
Bases:
SourceRegistry
- class openworld_radio_twin.providers.registry.AntennaSourceRegistry(sources=())[source]#
Bases:
SourceRegistry
- openworld_radio_twin.providers.registry.resolve_source(registry, requested, latitude, longitude, settings, *, allowed, fallback, reserved)[source]#
Resolve a source before acquisition; explicit selections never fall back silently.
reservedmaps the identifiers the caller implements itself (global,none) to their versions;fallbackis whatautobecomes when no source applies.