Package Exports

live-icomera-position

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (live-icomera-position) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

live-icomera-position

Live vehicle geolocation, taken from the on-board Icomera WiFi system.

ISC-licensed minimum Node.js version

Installation

npm install live-icomera-position

Usage

asStream() returns a readable stream in object mode.

const {asStream} = require('live-icomera-position')
const ndjson = require('ndjson')

const positions = asStream()
positions.on('error', console.error)
positions
.pipe(ndjson.stringify())
.pipe(process.stdout)

An individual data point will look like this:

{
    latitude: 50.9069,
    longitude: 7.0649,
    altitude: 36.9,
    speed: 97, // km/h
    nrOfSatellites: 8,
    mode: '3' // see below
}

You can also use the EventEmitter-based API:

const {asEventEmitter} = require('live-icomera-position')

const positions = asEventEmitter()
positions.on('error', console.error)
positions.on('data', data => console.log(data))

Mode

The mode value in a datapoint appears familiar with the one a widespread gps client called GPSD uses. We don't have any confirmation that the icomera system uses GPSD, but if it did the mode values would mean following:

Value	State
0	no value seen.
1	no position.
2	2D position, no altitude.
3	3D position, altitude present.

source: GPSD Documentation

Contributing

If you have a question or need support using live-icomera-position, please double-check your code and setup first. If you think you have found a bug or want to propose a feature, use the issues page.