Helium Positioning API
Project description
Helium Positioning API
Features
Prediction of the location of devices belonging to an organization in the Helium Console. The implementation of several different methods and models is planned.
Currently, only the nearest-hotspot-prediction method is implemented. This method uses the position of the hotspot with the highest signal strength to the corresponding device (RSSI value).
Installation
Developer install
The following allows a user to create a developer install of the positioning api.
pip install -r requirements.txt
poetry install
poetry shell
pip install git+https://github.com/emergotechnologies/helium-api-wrapper
Prerequisites
Before use, ensure that there is an .env
file in the root directory of the repository where the API_KEY
variable is entered (see .env.sample
). You can generate and copy the API_KEY
at https://console.helium.com/profile.
Usage
The service allows usage via command line interface or locally hosted REST interface.
CLI
Get Device Position
python -m helium_positioning_api predict --uuid 92f23793-6647-40aa-b255-fa1d4baec75d
Currently defaults to the "nearest_neighbor" model.
Advanced Requests
The location prediction command is
python -m helium_positioning_api predict --uuid 'your uuid' --model 'your model selection'
See the table below for a list of currently available commands and models.
command | position estimation model |
---|---|
nearest_neighbor | location of hotspot with the best signal |
midpoint | point of equal distance from the two hotspots with the best signals |
linear_regression | trilateration with an linear regression distance estimator |
gradient_boosting | trilateration with a gradient boosted regression distance estimator |
REST-API
- Start local REST-API (default)
python -m helium_positioning_api serve
- Open Browser and navigate to
127.0.0.1:8000/docs
- Click on
predict/{uuid}
endpoint to drop down the endpoint details - Click on the
Try it out
button. - Fill in the
uuid
of your device and click on the buttonExecute
- You can see the location prediction response in the
Responses
section below.
You can also just simply get the prediction by navigating to:
https://127.0.0.1:8000/predict/your-uuid
Contributing
Contributions are very welcome. To learn more, see the Contributor Guide.
License
Distributed under the terms of the MIT license, Helium Positioning API is free and open source software.
Issues
If you encounter any problems, please file an issue along with a detailed description.
Credits
This project was generated from @cjolowicz's Hypermodern Python Cookiecutter template.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for helium_positioning_api-0.0.2.dev1675377058.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 079c3d5c20e3c678caec125676973119e5b368dc959a151e78637e3080a672d3 |
|
MD5 | c4b0c096d8f9dbd994c3ad91d9dd5229 |
|
BLAKE2b-256 | f4215fc314964467dbda9c439962fc84fa60b2de096528fd00db32dbf9c71d65 |
Hashes for helium_positioning_api-0.0.2.dev1675377058-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 07c0b371d17833d7e3f476ecf4506bc8d62fc722cb867dc02b39bf5d9edab24b |
|
MD5 | 96f9db8e1a8979d088e4195029585fe8 |
|
BLAKE2b-256 | dcb35a65a90ee12d6ff0b6ff0b00bf11b5f8b3efc9a1dff73afa40978173fa98 |