/*! \page geolocation_page Geolocation \section geo_overview Overview The Geolocation window shows artifacts that have longitude and latitude attributes as waypoints on a map. In the field, when access to online map tile servers may not be available, the Geolocation window provides support for offline map tile data sources. \image html geo_main.png \section geo_usage Usage To open the Geolocation window, click on the "Geolocation" button near the top of the main window, or go to "Tools" and then select "Geolocation". \subsection geo_navigation General Usage You can move the map by clicking and dragging, and zoom using either the mouse wheel or the slider in the bottom left of the map. If a map tile is not available the tile will appear grey but the waypoints will still be displayed. This is more likely to happen when changing the default \ref geo_map_options. Different types of waypoint will be displayed different colors. You can use the key in the lower left to easily identify the type of each waypoint. Some types will also use different icons on the map. For example, individual track points will be displayed as smaller circles. The entire track will be highlighted when selecting an individual track point. \image html geo_track_points.png You can left click on a waypoint to highlight that waypoint and show a details pop-up in the upper right corner of the map. The details pop-up will be updated as you click on different waypoints. The data displayed will vary depending on the type of waypoint. For example, this is a GPS bookmark: \image html geo_details_bookmark.png While this is an image with GPS coordinates found by the \ref EXIF_parser_page : \image html geo_details.png You can also right click on a waypoint to bring up a similar menu to what you'd see in the \ref result_viewer_page. \image html geo_context_menu.png \subsection geo_filter Filtering The filters are displayed on the left side of the screen. The top filter lets you filter the waypoints based on timestamp. If enabled, you will only see waypoints with a timestamp within N days of the most recent waypoint (not the current date). When using this filter you can also choose whether you want to see waypoints with no timestamp. \image html geo_filter_time.png The second filter allows you to show waypoints only for the selected data sources. Note that only data sources that contain geolocation data are displayed here. \image html geo_filter_datasource.png The last filter allows you to only show certain types of waypoints. The number next to the type indicates how many waypoint of that type are in your case. \image html geo_filter_type.png Once you are done setting up your filters, click the "Apply" button at the top of the filter panel. If desired, the filter panel can be hidden by clicking on the vertical "Filters" tab on the top right edge of the filter panel. Clicking on that tab a second time will restore the filters panel. \subsection geo_report Generating a Report You can generate a KML report using the "KML Report" button in the bottom right corner of the window. The report will include only the currently visible waypoints and can be found in the "Reports" folder of your case. \image html geo_report.png As with other \ref reporting_page "report modules", the generated report will appear under "Reports" in the \ref tree_viewer_page. Note that you can also use the \ref report_kml report module to generate a report containing all geolocation data in the case. \section geo_map_options Map Tile Options

The Autopsy Geolocation window supports several map tile data source options. The map tile data source can be changed on the Geolocation panel in the Options dialog. There are four options for geolocation tile data, two of which can be used offline.

\subsection geo_generate_zip Using Maperative to Generate Tile Image Zip Files Maperative is a tool for drawing maps, however it can also be used to create tile images. Maperative download and documentations can be found at http://maperitive.net/ . By default Maperative uses an online tile server to generate the map. For offline use, users can supply an OpenStreetMap raw data extract. \subsubsection geo_generate_tile_image Generating tile image zip files using any map data source:
  1. Download and run Maperative.
  2. Center and zoom in on area of interest. The larger the area, the more tiles that will be generated. Tiles will be generated for the area visible in the map panel.
  3. Choose whether you want to use the default zoom levels or custom ones. Zoom levels in Mapertive start at 1. As the zoom level increases so will the quantity of tiles generated as well as the detail of each tile. Generating tiles, especially for heavily populated areas, may take time, please be patient with either method.
  4. For use in autopsy, the generated tile images need to be in a zip file. To create a zip of tiles for use in Autopsy, zip up all of the folders in the tile file output directory. Do not include the parent directory, just the numbered folders contained within. If you use the menu bar option or did not specify a folder in your command the generated tiles will be located in <Maperative Install Location>\\Tiles. \image html geo_tile_folder.png Be sure to zip only the contents of the folder, not the top level folder.
\subsubsection geo_add_ds Adding a data source to Maperative Maperative can be used to generate tiles using raw data extracts from OpenStreetMaps. Data extracts (*.osm or *.osm.pbf) files can be downloaded from various locations. See https://wiki.openstreetmap.org/wiki/Planet.osm for a list of locations. Geofabrik's free download server has open OpenStreetMap data extracts for many regions. When using OSM raw data extracts in Maperative, the recommendation is to use smaller (.osm) files. To add a data source to Maperative:
  1. Select from the menu bar File->Open Map Source... \image html geo_add_ds.png
  2. The new data source will appear in the bottom right corner of the window in the "Map Sources" list.
  3. To disable a Map Source, select the Map Source from the list and click the X button.
\subsubsection geo_merge_osm Merging OSM raw data extracts For ease of use, users may want to merge OSM raw data extracts. OSMConvert is a tool that can be used to merge OSM raw data extracts. To merge two OSM raw data extracts country1.osm.pbf and country2.osm.pbf use the following commands. Note that this assumes that osmcovert and the files are in the same directory; if they are not be sure to use full paths. \verbatim osmconvert country1.osm.pbf -o=country1.o5m osmconvert country2.osm.pbf -o=country2.o5m osmconvert country1.o5m country2.o5m -o=together.o5m osmconvert together.o5m -o=together.osm.pbf \endverbatim */