gps-util

GPS related functionalities. For getting and deleting gps info on an image one need to install exiftool.

http://www.sno.phy.queensu.ca/~phil/exiftool/index.html

Make sure exiftool is executable. if you have to install it manually on linux you can try ./scripts/install_exiftool.sh

Functions

getDistance(lng1, lat1, lng2, lat2)

Calculate distance of 2 given points

• lng1 longitude of point 1 in decimal degrees
• lat1 latitude of point 1 in decimal degrees
• lng2 longitude of point 2 in decimal degrees
• lat2 latitude of point 2 in decimal degrees

getTotalDistance(points)

Calculate total distance of a serial of points

• points array of point, example

  [{lat: 59.19288511388004, lng: 17.66255029477179 },{ lat: 59.19290036894381, lng: 17.662896132096648 }]

getBoundingBox(lat, lng, distance)

• lat latitude of the center, in decimal degrees.
• lng longitude of the center, in decimal degrees.
• distance radius that spans the bounding box, in meters.

return an array containing 2 points that represent the bounding box.

getMidPoint(points)

• points list of coordinate, each point with properties lat and lng

return Object/point with lat and lng

toDMS(decDegrees)

Convert decimal degrees to degrees, minutes and seconds (return an object)

getDMSLatitude(decDegrees)

Return a string representation in DMS format, ie 59° 19' 59.88" N

getDMSLongitude(decDegrees)

Return a string representation in DMS format, ie 18° 3' 0" E

toDD(degrees, minutes, seconds)

Convert to decimal degrees

gpxParse(data, callback)

• data xml string of gpx format
• callback function which take 2 arguments, error and result

gpxParseFile(filename, callback)

• filename file to parse the data in of gpx format
• callback function which take 2 arguments, error and result

gpxParseURL(url, callback)

• url where the gpx data is located
• callback function(error, result)

toGPX(trackingResult, callback, name)

• trackingResult
• callback function(error, result)
• name the name you want to call for this gpx document

toKml(points, callback)

• points Track points for instance returned value from gpxParse or tcxParse
• callback function(error, result)

tcxParse(data, callback)

• data xml string of tcx format
• callback function which take 2 arguments, error and result

tcxParseFile(filename, callback)

• filename file to parse the data in of tcx format
• callback function which take 2 arguments, error and result

tcxParseURL(url, callback)

• url where the tcx data is located
• callback function(error, result)

calculateFromGPX(points, callback, fromIndex, toIndex)

• points Track points for instance returned value from gpxParse
• callback function(error, result) result is a TrackingResult (see calc.js for details)
• fromIndex Integer from 0
• toIndex Integer from 1

imageGpsInfo(image, callback)

• image path to image to get GPS info
• callback function(error, result)

removeGPSInfo(image, callback)

• image path to image to delete GPS info
• callback function(error, result) result is boolean

geohashEncode(latitude, longitude, precision)

• latitude decimal latitude of the gps position
• longitude decimal longitude of the gps position
• precision number of chars to represent the gps position, default 12

geohashDecode(hash)

• hash hashed string representing the gps position
• return object of latitude, longitude, error