About LocationsAPI
What
LocationsAPI is a simple API to store and retrieve location data such as latitude and longitude. The API is REST and JSON based and provides easy ways to create, edit, view and delete locations. Location data can also include speed, heading, altitude and accuracy. Each set of locations is associated with a device allowing location data for many independent devices to be easily stored and retrieved.
Fine-grained access control is built-in through the use of roles and users. Security is provided through time-limited tokens and SSL.
The API is currently in Beta. If you would like access please get in touch.
Who
LocationsAPI is aimed at aimed at producers and users of telematics devices who want a simple way to store and retrieve location data.
Many producers of telematics devices have created bespoke ways to store the device data that make it hard to integrate into different systems. We want to change that by making it easy to save and retrieve telematics data using a modern API-based approach.
Milestones
- 15/08/2015 Initial launch
- 29/08/2015 Custom field requests, sorting and pagination added to /locations GET request
- 05/09/2015 Support for GeoJSON format for device locations requests (Accept: application/vnd.geo+json)
- 06/09/2015 Added rate-limit headers: 'X-RateLimit-'
- 19/09/2015 Created /trips resource. Trips derived from locations. Also supports GeoJSON format.
- 03/10/2015 Added 'flatten' option to /trips GET request to remove locations nesting.
- 04/10/2015 Added 'includeDevice' option to /trips GET request to also return the device object with the trips embedded.
- 18/10/2015 Timestamp always returned for trip locations - based on createdAt date if timestamp not provided
- 07/11/2015 Added 'includeDevices' option to /login requests to also return all the device uuids and names that the user can access.
- 12/12/2015 Globalstar support: new route added that supports Globalstar SPOT devices and we are a SPOT Value-Added Reseller. Contact us for more details.
- 05/03/2016 Added support for notifications when the device moves. All devices have an snsTopicARN that you can subscribe to for movement alerts.
- 19/03/2016 My Yacht App launches - using Locations API for store and retrieving locations. Take a look here.
- 24/03/2019 LocationsAPI rewritten as AWS Lambda functions using API Gateway for resilience and scale.
Development Plans
- Add notifications (alarms) based on location / movement etc.
- Support for additional telematics devices
- Public API status page