Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pulkin/mpy-agps
Micropython implementation of assisted location services (AGPS)
https://github.com/pulkin/mpy-agps
a9g agps database gps lbs micropython python
Last synced: 13 days ago
JSON representation
Micropython implementation of assisted location services (AGPS)
- Host: GitHub
- URL: https://github.com/pulkin/mpy-agps
- Owner: pulkin
- Created: 2019-12-26T21:35:03.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2020-04-22T22:29:55.000Z (over 4 years ago)
- Last Synced: 2024-11-18T16:57:40.672Z (25 days ago)
- Topics: a9g, agps, database, gps, lbs, micropython, python
- Language: Python
- Homepage:
- Size: 25.4 KB
- Stars: 11
- Watchers: 4
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-micropython - mpy-agps - MicroPython implementation of assisted location services (AGPS). (Libraries / Communications)
README
micropython-agps
----------------
For use with [micropython on GPRS module A9/A9G](https://github.com/pulkin/micropython/tree/master/ports/gprs_a9).
Examples
--------
### Location over internet connection:
```python
# Enable data connection
import cellular
cellular.gprs("apn", "user", "pass")
# Get location
import agps
agps.get_location_opencellid(cellular.agps_station_data(), "api-token") # Please visit https://opencellid.org for getting your API token
(78.86739615869062, 3.484547378491735)
```
### Location using local database:
Create a binary database of GSM cells:
```bash
~ ./bs-dl.py --mcc 234 --mnc 10 --circle=51.509865,-0.118092,3 -v --token api-token # Please visit https://opencellid.org for getting your API token
Target: 234-10.bin
Downloading https://opencellid.org/ocid/downloads?token=[token]&type=mcc&file=234.csv.gz ...
Unzipping ...
Parsing ...
Filtering ...
- mcc: 322671 -> 322671
- mnc: 322671 -> 99367
- circle: 99367 -> 2749
Sorting ...
Items total: 2749
Preparing tables ...
Saving ...
Total size: 33010 bytes
Done
```
Filtering is done through entries `mcc` - mobile country code, `mnc` - mobile network code and `circle` - location and radius of a circle with cells.
All entries are optional, however, the full worldwide database is as large as 1Gb.
Providing `mcc` and `mnc` will reduce the databse size down to few Mb.
Providing a `circle` will further filter data towards the circular area specified: 3 km of urban area results in around 10Kb of data.
Note that the token is optional: without a proper token, the script will fall back to a git mirror which may contain outdated data.
Then, upload the database to the module (note the file name):
```bash
ampy --port /dev/ttyUSB0 put 234-10.bin
```
Finally, determine the location (no data connection needed):
```python
# Get location
import agps
import cellular
agps.get_location_local(cellular.agps_station_data(), "234-10.bin")
(51.54547378491735, -0.11739615869062)
```
Raw data
--------
Please find [here](https://github.com/pulkin/agps-data).