Tracks and Locations

Tracks and Locations are key objects in the library. These are the objects we return following successful responses from ViewRanger.

#Location

A location represents a single BuddyBeacon waypoint, it is a point in time and space where a beacon was sent.

###Latitude This is the Latitude of the coordinate where user was when the beacon was sent.

###Longitude This is the Longitude of the location's coordinates.

###Date This is the date the BuddyBeacon was sent.

###Speed This is the speed in KM/hour the user was travelling at when the beacon was sent

###Heading This is the direction the user was travelling in, the number represents degrees from grid north for the WGS84 datum.

###Altitude This is the height above sea level (in metres) the user was at when the beacon was sent.

#Track The Track object represents a user's walk (cycle, sailing journey...), a collection of locations (or waypoints) which make up a line.

###Locations This property contains a collection of Location elements, these are the raw coordinates which make up the track.

###StartTime The earliest time a waypoint was recorded, the start of the activity.

###EndTime The last time a waypoint was recorded.

###Duration The time between the StartTime and EndTime, how long the track was recorded for

###TotalDistance The total length of the track made by measuring the distance between each waypoint (in metres).

###TotalHeightGain The total height which was climbed during the activity, this is calculated by summing each positive difference between the consecutive waypoints.