Sleuth Kit Java Bindings (JNI)  4.11.0
Java bindings for using The Sleuth Kit
org.sleuthkit.datamodel.blackboardutils.GeoArtifactsHelper Class Reference

Inherits org.sleuthkit.datamodel.blackboardutils.ArtifactHelperBase.

Public Member Functions

 GeoArtifactsHelper (SleuthkitCase caseDb, String moduleName, String programName, Content srcContent)
 
BlackboardArtifact addArea (String areaName, GeoAreaPoints areaPoints, List< BlackboardAttribute > moreAttributes) throws TskCoreException, BlackboardException
 
BlackboardArtifact addRoute (String routeName, Long creationTime, GeoWaypoints wayPoints, List< BlackboardAttribute > moreAttributes) throws TskCoreException, BlackboardException
 
BlackboardArtifact addTrack (String trackName, GeoTrackPoints trackPoints, List< BlackboardAttribute > moreAttributes) throws TskCoreException, BlackboardException
 

Detailed Description

An artifact creation helper that adds geolocation artifacts to the case database.

Definition at line 39 of file GeoArtifactsHelper.java.

Constructor & Destructor Documentation

org.sleuthkit.datamodel.blackboardutils.GeoArtifactsHelper.GeoArtifactsHelper ( SleuthkitCase  caseDb,
String  moduleName,
String  programName,
Content  srcContent 
)

Constructs an artifact creation helper that adds geolocation artifacts to the case database.

Parameters
caseDbThe case database.
moduleNameThe name of the module creating the artifacts.
programNameThe name of the user application associated with the geolocation data to be recorded as artifacts, may be null. If a program name is supplied, it will be added to each artifact that is created as a TSK_PROG_NAME attribute.
srcContentThe source content for the artifacts, i.e., either a file within a data source or a data source.

Definition at line 65 of file GeoArtifactsHelper.java.

Member Function Documentation

BlackboardArtifact org.sleuthkit.datamodel.blackboardutils.GeoArtifactsHelper.addArea ( String  areaName,
GeoAreaPoints  areaPoints,
List< BlackboardAttribute moreAttributes 
) throws TskCoreException, BlackboardException

Adds a TSK_GPS_AREA artifact to the case database. A Global Positioning System (GPS) area artifact records an area on the map outlines by an ordered set of GPS coordinates.

Parameters
areaNameThe name of the GPS area, may be null.
areaPointsThe points that make up the outline of the area. This list should be non-null and non-empty.
moreAttributesAdditional attributes for the TSK_GPS_AREA artifact, may be null.
Returns
The TSK_GPS_AREA artifact that was added to the case database.
Exceptions
TskCoreExceptionIf there is an error creating the artifact.
BlackboardExceptionIf there is a error posting the artifact to the blackboard.
IllegalArgumentExceptionIf the area points provided are null or empty.

Definition at line 200 of file GeoArtifactsHelper.java.

References org.sleuthkit.datamodel.Content.newDataArtifact(), org.sleuthkit.datamodel.blackboardutils.attributes.BlackboardJsonAttrUtil.toAttribute(), org.sleuthkit.datamodel.BlackboardAttribute.ATTRIBUTE_TYPE.TSK_NAME, and org.sleuthkit.datamodel.BlackboardAttribute.ATTRIBUTE_TYPE.TSK_PROG_NAME.

BlackboardArtifact org.sleuthkit.datamodel.blackboardutils.GeoArtifactsHelper.addRoute ( String  routeName,
Long  creationTime,
GeoWaypoints  wayPoints,
List< BlackboardAttribute moreAttributes 
) throws TskCoreException, BlackboardException

Adds a TSK_GPS_ROUTE artifact to the case database. A Global Positioning System (GPS) route artifact records one or more waypoints entered into a GPS-enabled device as a route to be navigated from waypoint to waypoint. A waypoint is a location in a geographic coordinate system with latitude, longitude and altitude (elevation) axes.

Parameters
routeNameThe name of the GPS route, may be null.
creationTimeThe time at which the route was created as milliseconds from the Java epoch of 1970-01-01T00:00:00Z, may be null.
wayPointsThe waypoints that make up the route. This list should be non-null and non-empty.
moreAttributesAdditional attributes for the TSK_GPS_ROUTE artifact, may be null.
Returns
The TSK_GPS_ROUTE artifact that was added to the case database.
Exceptions
TskCoreExceptionIf there is an error creating the artifact.
BlackboardExceptionIf there is a error posting the artifact to the blackboard.
IllegalArgumentExceptionIf the waypoints provided are null or empty.

Definition at line 147 of file GeoArtifactsHelper.java.

References org.sleuthkit.datamodel.Content.newDataArtifact(), org.sleuthkit.datamodel.blackboardutils.attributes.BlackboardJsonAttrUtil.toAttribute(), org.sleuthkit.datamodel.BlackboardAttribute.ATTRIBUTE_TYPE.TSK_DATETIME, org.sleuthkit.datamodel.BlackboardAttribute.ATTRIBUTE_TYPE.TSK_NAME, and org.sleuthkit.datamodel.BlackboardAttribute.ATTRIBUTE_TYPE.TSK_PROG_NAME.

BlackboardArtifact org.sleuthkit.datamodel.blackboardutils.GeoArtifactsHelper.addTrack ( String  trackName,
GeoTrackPoints  trackPoints,
List< BlackboardAttribute moreAttributes 
) throws TskCoreException, BlackboardException

Adds a TSK_GPS_TRACK artifact to the case database. A Global Positioning System (GPS) track artifact records the track, or path, of a GPS-enabled device as a connected series of track points. A track point is a location in a geographic coordinate system with latitude, longitude and altitude (elevation) axes.

Parameters
trackNameThe name of the GPS track, may be null.
trackPointsThe track points that make up the track. This list should be non-null and non-empty.
moreAttributesAdditional attributes for the TSK_GPS_TRACK artifact, may be null.
Returns
The TSK_GPS_TRACK artifact that was added to the case database.
Exceptions
TskCoreExceptionIf there is an error creating the artifact.
BlackboardExceptionIf there is a error posting the artifact to the blackboard.
IllegalArgumentExceptionIf the trackpoints provided are null or empty.

Definition at line 92 of file GeoArtifactsHelper.java.

References org.sleuthkit.datamodel.Content.newDataArtifact(), org.sleuthkit.datamodel.blackboardutils.attributes.BlackboardJsonAttrUtil.toAttribute(), org.sleuthkit.datamodel.BlackboardAttribute.ATTRIBUTE_TYPE.TSK_NAME, and org.sleuthkit.datamodel.BlackboardAttribute.ATTRIBUTE_TYPE.TSK_PROG_NAME.


The documentation for this class was generated from the following file:

Copyright © 2011-2021 Brian Carrier. (carrier -at- sleuthkit -dot- org)
This work is licensed under a Creative Commons Attribution-Share Alike 3.0 United States License.