OHDM Offline Viewer

Goal of this project

The goal of this repository is to render data from Open Historical Data Map. OHDM has its own data base structure but can provide data for a defined spatial temporal context - in other words: a data (a day) and a region (polygon). Those data can be produced in the OSM XML format which is well known from Open Street Maps. This viewer is an offline viewer. Map data are stored and rendered on the phone which makes apps independent from actual network connections.

To avoid caching dozens of different zoom layers, vector tiles are being used. This makes the navigation and zoom interaction fast.

Getting Started

Please read the Deployment and Installation Guide from the Wiki.

Follow these instructions to build and run the OHDM Offline Viewer

git clone https://github.com/OpenHistoricalDataMap/OfflineViewer.git
Install Android Studio.
Downlaod Open Historical Data maps
Import the project. Open Android Studio, click Open an existing Android Studio project and select the project. Gradle will build the project.
Connect your Android Device with your Computer.
Run the app. Click Run > Run 'app'. After the project builds you'll be prompted to build or launch an emulator. You then can choose your mobile phone.
Open View > Tool Windows > Device File Explorer and place your maps in your mobile phone device storage. There should be a OHDM (In the android emulator, you may have to create it: Device Explorerer > sdcard > New) directory in the internal storage.

Convert `.osm` to `.map`-files

Please read the documentattion from the OHDMWebServer

Use custom map-file download center

This application has an integrated download functionality for map files. This makes it possible to host various map files on a remote server. You then can easily download them using the app.

WARNING: At this point of development, the download center is a simple FTP server that does not meet any security requirements. Using it in productivity, will make your server extremely vulnerable.