location-utilities
Coordinate formatting, location calculation utilities, and NMEA sentence parser.
This module provides many useful functions:
- Formats ddmm.mmmmm or degrees minutes as DD or decimal degrees.
- Formats decimal degrees or DD as degrees minutes seconds or DMS.
- Formats DMS or degrees minutes seconds as DD or decimal degrees.
- Calculates horizontal accuracy which is the accuracy output on most GPS devices.
- Calculates the distance between two points.
- Parses all standard sentences of the NMEA protocol which includes $GPDTM, $GPGBS, $GPGGA, $GPGLL, $GPGLQ, $GPGNQ, $GPGNS, $GPGPQ, $GPGRS, $GPGSA,
$GPGST, $GPGSV, $GPRMC, $GPVTG, and $GPZDA.
- Supports metric and imperial units.
Love my modules?
Installation
npm install location-utilities --save
Node usage
var LocationUtility = require('path-to-module-index-file/index.js');
Angular usage
import { LocationUtility } from 'location-utilities';
Current module functions
Returned Unit of Measure
Parse NMEA sentence
LocationUtility.parseNMEA(NMEASentence, unit);
Parse NMEA sentence with an interface
LocationUtility.parseNMEA(NMEASentence, 'imp') as LocationUtility.GGA;
Parse specific NMEA sentence
LocationUtility.parseGGA(NMEASentence, 'imp');
Calculate horizontal accuracy
let parsedGST = LocationUtility.parseGST(NMEAGSTSentence, 'imp');
LocationUtility.horizontalAccuracy(parsedGST.stdLatitudeError, parsedGST.stdLongitudeError, 'imp');
Format degrees minutes as decimal degrees
LocationUtility.DMToDD(latitudeDirection, latitude, longitudeDirection, longitude);
Format latitude degrees minutes as decimal degrees
LocationUtility.DMLatToDD(latitudeDirection, latitude);
Format longitude degrees minutes as decimal degrees
LocationUtility.DMLongToDD(longitudeDirection, longitude);
Format latitude decimal degrees as degrees minutes seconds
LocationUtility.DDLatToDMS(latitude);
Format longitude decimal degrees as degrees minutes seconds
LocationUtility.DDLongToDMS(longitude);
Format degrees minutes seconds as decimal degrees
LocationUtility.DMSToDD(longitude);
Calculate distance between two points
LocationUtility.calculateDistance(point1Latitude, point1Longitude, point2Latitude, point2Longitude, unit);