helium-positioning-api 0.0.2.dev1675363498

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

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.