iss

A module that, given an ID and a request rate, returns a readable stream which emits location data for the corresponding satellite

Install

npm install iss --save

API

Head to https://api.wheretheiss.at/v1/satellites for supported satellites.

locationStream

iss.locationStream(id, rate) presents a stream of JSON containing locational data for the satellite with id id where rate is max num. requests per second.

Example:

var iss = require('iss');

// Location stream for the ISS, maximum 10 requests per second.
var stream = iss.locationStream(25544, 10);

stream.on('data', function (buffer) {
    var rawJson = buffer.toString('utf8'),
        data    = JSON.parse(rawJson);
    console.log();
    console.log('Latitude: ' + data.latitude);
    console.log('Longitude: ' + data.longitude);
    console.log('Velocity: ' + data.velocity);
    // And so on...
});

changeInLocationStream

iss.changeInLocationStream(id, rate) presents a stream of JSON containing long/lat per second for the satellite with id id where rate is max num. requests per second.

var iss = require('iss');

// Change in location stream for the ISS, maximum 10 requests per second.
var stream = iss.changeInLocationStream(25544, 10);

stream.on('data', function (buffer) {
    var rawJson = buffer.toString('utf8'),
           data = JSON.parse(rawJson);
    console.log();
    console.log('Latitude per sec: ' + data.latPerSec + '/s');
    console.log('Longitude per sec: ' + data.longPerSec + '/s');
});

Demo

Print live stream of long/lat per second to console:

node live.js

Development

npm install              # Setup
npm test                 # Unit tests (mock data)
npm run-script coverage  # Generate and open unit coverage report (html)