Skip to content

Latest commit

 

History

History
113 lines (80 loc) · 3.44 KB

README.md

File metadata and controls

113 lines (80 loc) · 3.44 KB
Raw

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