helium-positioning-api 0.0.2.dev1675377058

Helium Positioning API

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

1. Start local REST-API (default)

   python -m helium_positioning_api serve
   

2. Open Browser and navigate to 127.0.0.1:8000/docs
3. Click on predict/{uuid} endpoint to drop down the endpoint details
4. Click on the Try it out button.
5. Fill in the uuid of your device and click on the button Execute
6. 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.