account_circle Creating an account
Creating a Coposition account allows you to store, control access to, and manage your location data through the Coposition platform. You can manage all of your Coposition-connected devices through one account, using the Coposition app across your trackers as well as the Coposition online dashboard. Using the Coposition platform is free for private/non-commercial users, as are the Coposition mobile apps.
To create a Coposition account online, click sign up on the Coposition homepage or go to https://coposition.com/users/sign_up. Enter your details, and include a username if you’d like to share your location privately with friends through the Coposition platform.
smartphone Via the app
Open the Coposition mobile app on your tracker (phone, tablet, etc.). On the welcome screen, select 'Create one' below the email and password fields. Enter your details then press 'Sign Up' and you will be logged into the Coposition app.
file_download Downloading the apps
The Coposition mobile apps are free to download from the App Store and Play Store. When you first open the apps, you will be asked for various permissions. In the interest of privacy and security, we’d like to be transparent about exactly why Coposition needs these permissions:
Access approximate and precise location (GPS and network based)
To create your location data
Modify or delete the contents of your SD card
To store your location data while waiting to upload to the Coposition servers and to remember your settings
Read the contents of your SD card
To access your location data when stored locally, and remember your settings
Motion & Fitness Activity
To improve location accuracy and battery efficiency
Location while using the app
To create your location data
Send you notifications
To notify you of Coposition friend requests, new app versions, when your mobile settings do not allow Coposition to perform properly and to enable some Coposition features
To create your location data in the background, when auto check-in is ON.
Before you can create a check-in, you must first have created a device for this check-in to be assigned to. Every check-in is assigned to a device, whether that device is assigned to a tracker (phone, tablet, etc.) or not. There is no limit to the number of devices you can have, and you can choose which Coposition device is assigned to each of your trackers. You can customise the permissions for each device you own, giving you control over how your data consumers (Coposition enabled apps and your Coposition friends) can access your location.
add Creating a Device
You can create a device through the Coposition online dashboard or via the Coposition mobile app
To create a new device online, go to your devices tab and click the yellow CREATE DEVICE button. You can then give this device a name and select the type of tracker you will connect this device to. These can be updated later. The Coposition UUID is used to sync this new device to 3rd party apps or hardware - more info here.
When you first sign in to the Coposition mobile app, or when you first sign into the mobile app on a tracker that you have not signed in on before, a new device will be created for you in Coposition. You can rename this device by tapping on the name in the top of the menu, accessible from the top left of the home screen.
swap_horiz Switching Devices
A device can be assigned to a tracker, or exist as an unassigned device. To change the device that is assigned to a tracker:
- Open the Coposition app on that tracker and navigate to the 'My Account' screen. Your devices will be listed here, with the device currently receiving check-ins from that tracker highlighted in blue.
- Select the device that you would like to assign to this tracker, to see the Device summary. This screen will indicate if that device is currently assigned to another tracker.
- If the device is not assigned to another tracker, you will see the 'Switch to this device' button at the bottom of your screen. You cannot assign a device that is already assigned to another tracker.
settings Device Settings
Device settings can be managed from the settings menu in the mobile app or from your devices screen online.
Fogging allows you additional control over how much of your location data your data consumers (friends and apps) can see. Fogging a check-in or a device will mean that your data consumers will not be shown your exact location or coordinates, instead they will see a location usually localised to the nearest city/town or a randomised location within 50km of your actual location if there are no settlements nearby.
Fogging is enabled by default when you create a device. Whilst on, you can choose to allow certain friends or apps to see precise data by enabling bypass fogging via permissions.
Delay allows you additional control over when your data consumers (friends and apps) can view your location data. Delay represents how long after creation your consumers will be able to see your data.
E.g. if you created a checkin at 11:00 on a device with a delay of 5 minutes, your friends/apps would not be able see this checkin until 11:05.
Delay is not set when you first create a device. Once you have set a delay you can choose to allow certain friends or apps to see your data immediately by enabling bypass delay via permissions.
Cloaking a device hides it and all of its check-ins from all of your friends and apps. It also disables the device's shared page if the device is shared.
perm_device_information Device UUID
Device UUID is a unique identifier for existing Coposition devices and is primarily used in the developer API. Some apps may request a device UUID to sync this device to their app or some hardware (eg. a dedicated tracker) may come pre-packaged with a Coposition UUID that you can use to sync the hardware to your Coposition account.
settings Device configuration
Device configuration is used by some apps to apply additional device setttings.
E.g. a tracking device might have additional settings such as how often the tracker sends checkins, which you could update via the associated tracking app.
A check-in is an individual unit of location data, and includes information like time, date, coordinates, altitude (where available), and device settings. Once you have created a device, you can start creating check-ins via the Coposition website and the Coposition app.
The mobile app is the easiest and most common way to create check-ins.
You can click the Check-in icon on the home screen to create a check-in where you are currently located.
Select Settings from the menu in-app. There you can turn auto check-in on and customise how often these check-ins are created by selecting a check-in interval. You can also select to ignore similar locations, to avoid creating excessive location data. You can also choose a battery saving mode.
There are three ways to create check-ins online.
From your devices tab, select ‘remote check-in’ for the desired device. This will attempt to communicate with the tracker which this Coposition device is assigned to, and if the tracker has a data connection and has location enabled it will create a check-in.
From your devices tab, select a device by clicking its name. Right click on the map where you would like a check-in created, and select ‘create check-in here’. You can then edit the location, date, and time of the check-in as well as fog or delete it.
From your devices tab, select a device by clicking its name. Click the blue check-in button and select from the options presented. Check-in now will set the location as that of the browser you are on, whereas remote check-in will use the current location of the selected device’s tracker.
recent_actors Friends and Apps
By adding friends and apps in Coposition, you can start to control how these data consumers access your location data. Add friends to securely share your location with them, and connect and authorise apps to start controlling how they access your location data.
add_circle Adding friends
To add a friend, visit the friends page and click the orange plus at the top of the page. You can then enter an email address, either of an existing user or of a friend you would like to invite to use Coposition. This will send an email either notifying the user that they have received a friend request or that you have invited them to sign up with Coposition.
add_circle Adding apps
To allow external applications to access your location data, you must authorise their access to your Coposition account.
Connecting and authenticating an external application, to allow access to your location data, can be started from the external application or from the Coposition website. Starting the process through the Coposition website is recommended, in order to customise the application’s access to your devices and location data before authenticating the app and giving the app developers access to your data.
To connect online:
- From your Apps tab, click the CONNECT NEW APP button in the top right corner.
- Enter the app you would like to connect to. Potential matches will be displayed as you start typing.
- Select the app you’d like to connect to, and click ADD. You will return to the apps tab and will see this app listed in your apps Requiring Authentication. These apps cannot access your data, but you can edit their PERMISSIONS to limit their data access as you please once authentication is completed. You can also DISCONNECT from these apps.
To authorise online:
- Apps listed as Requiring Authentication give you the option to AUTHENTICATE. Clicking this will take you to the external app where you will be able to authorise the external application to access your Coposition data.
To connect and authorise from an external app:
- Every external app will handle this slightly differently, but they will ask you to permit their access to your Coposition account. You will be taken to a Coposition page and asked to login to your Coposition account.
- After entering your Coposition account email address and password you will then be asked to authorise or deny the application’s access to your data. If you deny access, you can always complete the process again.
Once you have authenticated an external app, you can manage its access to device data (and turn off access completely) from the apps and Devices tabs online, and from the Permissions screen in the Coposition mobile app.
You can turn off an external application’s access to your device data without revoking the authentication you have given that app. Think of it this way:
Connected:The external app knows that you have a Coposition account. It cannot make a request for your location data.
Authenticated:The external app has the ability to request your data. You can still manage your settings to ensure that your Coposition account says ‘no’ to this request!
Permissions allow you additional controls over how much of your data a specific consumer (friend or app) can see for a specific device.
Stops a consumer from seeing any location data for a device.
Allows a consumer to see precise location data for a device regardless or whether it is fogged and/or delayed.
E.g. you might decide that you want a particular friend to be able to see your exact location for a fogged device. You can achieve this by enabling 'bypass fogging' for that friend on that device. This will allow them alone to see the device's data location as if it were not fogged.
Last check-in only/Full history
Allows you control over whether the consumer can see just the most recent checkin for a device or all of it's checkins. Fogging and delay still apply.
visibility Viewing your check-ins
By creating your location data using the Coposition mobile app, you have full access to, and control over, your location history. You can view your location history through the mobile app and via your dashboard.
smartphone Mobile app
Select check-in history from the menu in-app. Depending on how active you’ve been, you’ll either see:
- All check-ins from past 24 hours, up to most recent 50 check-ins
- Most recent 10 check-ins, if 10 or fewer in past 24 hours
You can toggle whether these check-ins are displayed as a path or as individual points, with the line moving from dark blue to grey with age if path is selected. You can view any specific check-in online by selecting it and then either copying the link or selecting to open in your browser.
When it comes to viewing check-ins and managing them, your online dashboard has much greater functionality. To view your check-ins, go to your Devices tab. There you’ll be able to view check-ins associated with an individual device of yours by clicking on the device name, or viewing all data for all devices of yours by clicking View All Check-ins. Using the toggles on the left of the map, you can toggle the path on/off and select a map style, like on the mobile app. When viewing any dataset online you will also have additional processing options.
When viewing the check-in history for a device online, Coposition displays City View by default. This aggregates (clusters) all check-ins within the same city or town to give an approximation of your location history.
For your detailed history, you can toggle City View off by clicking the City View icon in the map options. City view still only displays locations within the selected date range.
By default, you will see the last 5000 check-ins that you have created regardless of how many cities these check-ins have been created within. By selecting a date range you can customise the number of check-ins used when displaying your map.
Searching for a check-in
To search for a specific check-in, you can view your device(s) online and search for a location in the top right corner of the map. If you know the ID of a check-in, you can enter this on your Devices page to see data about that check-in.
w3w or 'what3words' is a unique combination of 3 words that identifies a 3mx3m square, anywhere on the planet. Learn more about what3words.
file_download Back-up, restore, and view in other programs
You can download your check-ins in a variety of formats in order to have a permanent local copy of your data. If you wish, you can also use this as a data backup, and reupload check-ins at a later date to overwrite any changes or deletions you may have made. Check-ins must be uploaded in CSV format.
When uploading check-ins from a CSV file, it is possible that existing check-ins will be overwritten. This will only occur if you download your check-in history, and then re-upload this same history having edited the CSV file you downloaded.
Simple comma-separated values in rows. This is the best format for doing analysis (eg. filtering or mathematical) on the data. CSV is usually viewed with a spreadsheet programme.
The CSV file downloaded will include the following headers:
id, lat, lng, created_at, updated_at, uuid, device_id, address, city, postal_code, country_code, fogged, fogged_lat, fogged_lng, fogged_city, output_lat, output_lng, output_address, output_city, output_postal_code, output_country_code, fogged_country_code, edited, speed, altitude
To view a CSV file, you can use Google Sheets.
GeoJSON is a format for encoding a variety of geographic data structures. It is a useful format for many mapping programmes. Learn more about GeoJson.
Coposition returns your check-ins as a FeatureCollection, with each individual check-in an individual feature which includes the latitude, longitude and id of the check-in.
To visualise, use Geojson Lint.
A standard XML format for GPS data. A useful format for GPS devices and online mapping.
Coposition creates a GPX track where each of your check-ins is represented by a GPX point. These points include your elavation, latitude, longitude and time the check-in was created.
You can learn more about the official GPX schema here.
To visualise, use GPS visualizer.
Yes! We currently have zapier triggers available for both developers and users.
Zapier moves information between apps and allows you to automate actions in one app based on actions and events in another.
Developers can make use of an approval trigger which fires every time an approval is created by a developer or accepted by a user.
Users can make use of a checkin or device trigger which fires whenever a new checkin or device is created.
Get started at zapier.com
Coposition is dedicated to ensuring our users' data is protected. Our terms and conditions outline the relationship between Coposition, users, and their data. Coposition meets and exceeds the minimum standards for the EU's GDPR.
help More questions
Click 'How can we help?' below to chat directly to our Coposition support team.