You start using an app that requires your location, let's call it LifeInvader.
LifeInvader will immediately start tracking your location.
But, if LifeInvader used Coposition, you'd have control over how much location data they have access to, how accurate it is and when they can see it.
With one click you can completely disable LifeInvaders access to your location, keeping your data yours.
A very easy to use HTTP REST API, giving you some cool location-aware data.
Instant trust from your users.
Open source. If you see something you think could be improved, improve it!
Add the following routes to your /etc/hosts
127.0.0.1 api.coposition-dev.com
127.0.0.1 coposition-dev.com
bundle
rake db:create && rake db:migrate && rake db:seed
Create a user with the username testuser.
Create a developer.
Note the API key found on the developer dashboard.
To start posting a checkin, you need to tell us which device you're posting to. This is determined by the UUID of the device. If you're creating a new device, all you need to do is request a new UUID
GET http://api.coposition-dev.com/uuid
Headers: X-API-KEY: YourApiKey
POST http://api.coposition-dev.com/checkins
Headers: X-API-KEY: YourApiKey, X-UUID: YourDeviceUUID
With the payload:
{
"lat":"51.588330",
"lng":"-0.513069"
}
If you then go to http://coposition-dev.com/users/testuser/devices > Add a device, enter the UUID, the device will be bound to your account with the check-in you created.
POST http://api.coposition-dev.com/users/testuser/approvals
Headers: X-API-KEY: YourApiKey
If you go to the user dashboard, you'll now see an approval request from the company you created.
Approving this allows the company to have access to that user's location data of all devices (by default).
GET http://api.coposition-dev.com/users/testuser/devices
Headers: X-API-KEY: YourApiKey
Returns an index of devices.
GET http://api.coposition-dev.com/users/testuser/checkins
Headers: X-API-KEY: YourApiKey
Returns an index of check-ins belonging to the testuser.
Copyright 2016 Earlymarket LLP