PureTrack Insert API
PureTrack provides a simple API endpoint to insert JSON data. To use this you'll need to be issued an insert key for your application. Contact Us to obtain a key.
The API is used to insert new data, so your app needs to keep track of what you've already sent to PureTrack.
Multiple location points can be sent in one call, so you can buffer multiple points into a single HTTP request. This reduces the number of requests, and reducing device power by not transmitting data as frequently. For example, you could record locations every 5 seconds, but send to the server every minute.
Recommended intervals between data points:
- 1-2 seconds - not recommended, creates excessive data for no real benefit. Avoid offering as an option to your users.
- 3-5 seconds - good for thermals and accurate corners.
- 5-60 seconds - good for general usage.
- 1-10 minutes - good for location safety and minimal data.
- Over 10 minutes - not recommended, PureTrack's default filter is to hide data over 10 minutes old.
- Variable - ideal. Faster intervals while cornering. Longer intervals while travelling straight lines.
POST https://puretrack.io/api/insert
Example call
{
"rego": "ZK-GOP",
"label": "asdf",
"key": "{YOUR_KEY_GOES_HERE}",
"type": 9,
"deviceID": "1234",
"username": "timbo"
"points": [
{
"ts": 1713563621,
"lat": -41.2334745,
"lng": 174.348365,
"alt": 345.1,
"speed": 25,
"course": 270,
"vspeed": 5.3
},
{
"ts": 1713563624,
"lat": -41.1634343,
"lng": 174.36545,
"alt": 335.1,
"speed": 28,
"course": 240,
"vspeed": 5.1
},
{
"ts": 1713563629,
"lat": -41.194343,
"lng": 174.38545,
"alt": 325.1,
"speed": 29,
"course": 190,
"vspeed": 5.0
}
]
}
List of parameters
- Rego - Optional. If a registered aircraft, this is the full registration.
- label - Optional. The default label to be displayed on PureTrack. Will not be used if rego is supplied.
- key - Required. your app key.
- type - Optional. A full list of types can be found at https://puretrack.io/types.json.
- deviceID - Optional. A unique ID or username for your device/user. If a user wants to link this device to other sources in PureTrack they will need to know what this is.
- username - Optional. UserID on your system. We can optionally link back to your user's account with this ID number.
Point Data
- ts - Required. Timestamp of the data point as an Epoch Unix Timestamp.
- lat - Required. Decimal format.
- lng - Required. Decimal format.
- alt - Optional. Meters.
- speed - Optional. Meters per second.
- vspeed - Optional. Vertical speed. Meters per second.
- course - Optional. Bearing or course. Degrees from 0 to 360
