node package manager


Node.js module which provides an Dronetrack API client

Dronetrack API

This is a simple node module for integrating with the Dronetrack API

Pre-Requisites and Installation

You will need to create an account on Dronetrack and get clientId, clientSecret and redirect url to receive access token value.

npm install dronetrack

Using Dronetrack Client

var dronetrack = require('dronetrack');

Type Drone allows user to manage user's drones

var droneApi = new dronetrack.Drone('baseUrl', 'accessToken'); //you can get accessToken with dronetrack.OAuthHelper
droneApi.all(function(err, drones){...});
droneApi.get(id, function(err, drone){...});
droneApi.create({name: 'name'}, function(err, drone){...});
droneApi.update({id: id, name: 'name'}, function(err, drone){...});
droneApi.remove(id, function(err){...});
// Adding points to new track
droneApi.addPoints(id, [{latitude: latitude, longitude: longitude, timestamp: timestamp}, ...], function(err, res){ /* res.trackId will be contain id of created track */...}); 
// Adding points to exisiting track
droneApi.addPoints(id, trackId, [{latitude: latitude, longitude: longitude, timestamp: timestamp }, ...], function(err){...}); 
// Import points to new tracks from csv files
// New track will be created for each file. File name  without extension will be used as track name.
droneApi.importPointsFromFiles(id, ['/path/to/file1', ...], 'csv' function(err){...}); 
// Import points to new tracks from kml files
droneApi.importPointsFromFiles(id, ['/path/to/file1', ...], 'kml' function(err){...}); 

Type Track allows user to manage tracks tracks

var trackApi = new dronetrack.Track('baseUrl', 'accessToken'); //you can get accessToken with dronetrack.OAuthHelper
trackApi.all(function(err, tracks){...});
trackApi.get(id, function(err, track){...});
trackApi.create({name: 'name', deviceId: droneId}, function(err, track){...});
trackApi.update({id: id, name: 'name'}, function(err, track){...});
trackApi.remove(id, function(err){...});
trackApi.getPoints(id, function(err, points){...});
// Adding points to new track
trackApi.addPoints(id, [{latitude: latitude, longitude: longitude, timestamp: timestamp}, ...], function(err, points){...}); 
// Import points to new tracks from csv files
// All exisiting points will be overwriten
trackApi.importPointsFromFiles(id, ['/path/to/file1', ...], 'csv' function(err){...}); 
// Import points to new tracks from kml files
trackApi.importPointsFromFiles(id, ['/path/to/file1', ...], 'kml' function(err){...}); 

Dronetrack API uses OAuth 2.0 to authorize user. To get access token you can use type OAuthHelper

var auth = new dronetrack.OAuthHelper('baseUrl', 'clientId', 'clientSecret', 'redirectUrl'); // you must receive clientId, clientSecret and redirectUrl from Dronetrack site
auth.getAccessToken(function(url, callback){
    // You should redirect to this 'url' (for web apps) or open this 'url' in browser (for other apps)
    // User will sign in on Dronetrack site (if need) and confirm decision to allow your app to work with Dronetrack API.
    // Then Dronetrack site will redirect user to 'redirectUrl' putting pin code value as query parameter 'code' (for web apps)
    // If your 'redirectUrl' is 'http://localhost' (for non-web apps) pin code will be shown to user. You should promt to enter this value by user.
    // Anyway you should pass this code as second parameter of callback function (like callback(null, code);)
}, function(err, accessToken));
//You should save accessToken value to use it in future.