About coordinates trails (GPS)

Clearance Developer Guide

Content type
Guides > Developer guides
Product line
Clearance
Language
English
Applies to
Genetec Clearance

The coordinate trail is an advanced Genetec Clearance™ feature that uses GPS to record and display an entity's movement on playback of video Evidence. Coordinate trails allow Clearance users to access precise data about the location, speed, and direction of objects of interest.

Make sure to review Uploading a file before continuing.

Clearance supports a coordinates trail display feature during video playback. To use this feature, the video evidence must fulfill these criteria:

  • The evidence must be uploaded using the API.

  • An additional Coordinates Trail resource file must be sent along with the video file resource before completion.


image

The resource file must have the Mimetype genetec/video-location and content similar to the following Sample coordinates location file:

{
   "CoordinateEntries":[
      {
         "LocationWKT":"POINT(-73.8636711 45.4713071)",
         "SecondsFromStart":0.0,
         "Timestamp":"2017-05-23T19:34:33.01Z"
      },
      {
         "LocationWKT":"POINT(-73.8636711 45.4713071)",
         "SecondsFromStart":3.0,
         "Timestamp":"2017-05-23T19:34:36.01Z"
      },
      {
         "LocationWKT":"POINT(-73.8636676 45.4713056)",
         "SecondsFromStart":4.0,
         "Timestamp":"2017-05-23T19:34:37.01Z"
      },
      {
         "LocationWKT":"POINT(-73.8636845 45.4713138)",
         "SecondsFromStart":5.0,
         "Timestamp":"2017-05-23T19:34:38.01Z"
      },
      {
         "LocationWKT":"POINT(-73.8636768 45.4713143)",
         "SecondsFromStart":6.0,
         "Timestamp":"2017-05-23T19:34:39.01Z"
      },
      {
         "LocationWKT":"POINT(-73.8636765 45.4713188)",
         "SecondsFromStart":7.0,
         "Timestamp":"2017-05-23T19:34:40.01Z"
      }
   ]
}

Coordinates format:

public class Coordinates
{
  public List<CoordinateEntry> CoordinateEntries { get; set; }
}

public class CoordinateEntry
{
  public string LocationWKT { get; set; }

  public double SecondsFromStart { get; set; }

  public DateTime Timestamp { get; set; }
}

The LocationWKT property is build using the Well-Known Text format.