colin/ols
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

README.md: Add info on entry points and cellid import, improve

Browse Source
This commit is contained in:
Teemu Ikonen
2023-03-30 16:06:54 +03:00
parent de84ffa2e5
commit 8c844486e4
1 changed files with 31 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
README.md
View File

@@ -1,11 +1,12 @@
# Offline Location Service # Offline Location Service
A prototype HTTP location service with Mozilla Location Service (MLS) A HTTP location service with Mozilla Location Service (MLS) compatible API.
compatible API. Not a web service, but a device-local server with caching Takes a list of locally observed wifi access points and / or mobile cell ids
databases and the aim of minimizing network access and information leakage. and returns a latitude and longitude using various data sources. Not a web
Designed to be run on Linux with service, but a device-local server with caching databases and the aim of
[GeoClue](https://gitlab.freedesktop.org/geoclue/geoclue) but may also work minimizing network access and information leakage. Designed to be run on Linux
on other platforms. with [GeoClue](https://gitlab.freedesktop.org/geoclue/geoclue) but may also
work on other platforms.
## Requirements ## Requirements
@@ -39,6 +40,10 @@ Python module
python3 -m ols -d debug -C ols.toml python3 -m ols -d debug -C ols.toml
or using the entry point scripts under `bin`
bin/ols -d debug -C ols.toml
Alternatively, you can make a local install from the source tree with Alternatively, you can make a local install from the source tree with
[pipx](https://pypa.github.io/pipx/) [pipx](https://pypa.github.io/pipx/)
@@ -74,6 +79,26 @@ The Geoclue demo application can be now used to test the locator:
If you are running OLS with the debug logging enabled (`-d debug`), OLS should If you are running OLS with the debug logging enabled (`-d debug`), OLS should
now output a lot of log messages and the demo app should print your location. now output a lot of log messages and the demo app should print your location.
### Cellid data
If you have a device with a ModemManager supported cell modem, GeoClue will
receive cellid data and pass it to the location service, i.e. OLS.
Cellid location data can be downloaded in the opencellid CSV format from
[Mozilla](https://location.services.mozilla.com/downloads) or
[opencellid.org](https://opencellid.org/) (requires registration).
The `cellid-ols-import` command under `bin` can be used to convert the
downloaded CSV files to an sqlite3 database which can be used by the 'cellid'
resolver in OLS. It's very much recommended to use the `--mcc` and `--mnc`
arguments to `cellid-ols-import`, so that the database contains only the cell
ids of your operator.
You can use this command to find the MCC and MNC of the cell which your device
is currently using:
mmcli -m any --location-enable-3gpp && mmcli -m any --location-get
## See also ## See also
* MicroG * MicroG