Mappers API
Introduction
The Mappers API is a set of HTTP requests used for submitting data to the Mappers project. Data submitted is viewable on mappers.helium.com and updated every six hours starting at 04:20 UTC.
Authentication
There is currently no authentication required.
Ingest Uplink
POST https://mappers.helium.wtf/api/v1/ingest
Submit geo tagged device uplink.
Content-Type: application/json
Requests are intended to be sent from an HTTP integration within Console.
Metadata from the standard JSON message is used in addition to the required
fields detailed below.
All required fields can be located at any level within the decodedJSON
field.
All of the following fields are required latitude, longitude, altitude.
One or more of the following are required accuracy, hdop, sats.
- Request
- Response
Body Parameters
| Parameter Name | Type | Description |
|---|---|---|
| latitude (required) | number | Device Latitude Value |
| longitude (required) | number | Device Longitude Value |
| altitude (required) | number | Device Altitude Value |
| accuracy (one or more) | number | Device GPS Accuracy Value |
| sats (one or more) | number | Device Visible Satellites Value (1-16) |
| hdop (one or more) | number | Device HDOP Value (1-10) |
200: OK
Request submission successful
Success
400: Bad Request
Required request parameters not found.
Invalid Fields