How mozilla/ichnaea works
Ichnaea is the archived Mozilla Location Services backend: it accepts location queries and observation submissions, maintains radio-station data, and serves data and statistics. The tree and excerpts support the background-task dispatch and parts of the query/model layers; they do not show the full web routing or locate/submit execution path. Dashed locate links indicate unverified relationships rather than confirmed calls.
Main entry points: tasks.py Scheduled tasks · searcher.py Location search · views.py Observation submission · observation.py Report models
Components 20
Location API
- Locate endpoint
ichnaea/api/locate/views.py - Query validation
ichnaea/api/locate/query.py - Location search
ichnaea/api/locate/searcher.py - Fallback lookup
ichnaea/api/locate/fallback.py - GeoIP lookup
ichnaea/api/locate/geoip.py - Internal lookup
ichnaea/api/locate/internal.py - Location result
ichnaea/api/locate/result.py - Observation submission
ichnaea/api/submit/views.py
Observation Data
- Report models
ichnaea/models/observation.py - Station models
ichnaea/models/station.py - Radio network models
ichnaea/models/cell.py - Database access
ichnaea/db.py
Background Processing
- Task runtime
ichnaea/taskapp/app.py - Scheduled tasks
ichnaea/data/tasks.py - Station updates
ichnaea/data/station.py
Data and Content
- Data exports
ichnaea/data/export.py - Public datasets
ichnaea/data/public.py - Usage monitoring
ichnaea/data/monitor.py - Content and statistics
ichnaea/content/views.py
Other components
- API client
Connections 16
- API client → Locate endpoint: requests location
- API client → Observation submission: submits reports
- Query validation → Location search: provides query
- Location search → Fallback lookup: uses lookup
ichnaea/api/locate/searcher.py - Location search → GeoIP lookup: uses lookup
ichnaea/api/locate/searcher.py - Location search → Internal lookup: uses lookup
ichnaea/api/locate/searcher.py - Location search → Location result: uses result
ichnaea/api/locate/searcher.py - Observation submission → Report models: validates reports
- Task runtime → Scheduled tasks: runs tasks
ichnaea/data/tasks.py - Scheduled tasks → Station updates: dispatches updates
ichnaea/data/tasks.py - Scheduled tasks → Data exports: dispatches exports
ichnaea/data/tasks.py - Scheduled tasks → Public datasets: dispatches exports
ichnaea/data/tasks.py - Scheduled tasks → Usage monitoring: dispatches monitoring
ichnaea/data/tasks.py - Scheduled tasks → Content and statistics: dispatches statistics
- Station updates → Database access: accesses database
ichnaea/data/station.py - Report models → Radio network models: uses radio types
ichnaea/models/observation.py