View OHDM maps offline
The goal of this repository is to render Open Street Maps, without the need of a network connection. To avoid caching dozens of different zoom layers, vector tiles are being used. This makes the navigation and zoom interaction fast.
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 projectand 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 Explorerand place your maps in your mobile phone device storage. There should be aOHDM(In the android emulator, you may have to create it:Device Explorerer > sdcard > New) directory in the internal storage.
We're using osmosis with the mapsforge-map-writer-plugin
to convert .osm maps to .map.
In order to use osmosis, just execute /osm2map/osm2map.sh as sudo.
The following code-block shows a successful execution:
user@host:~$ sudo bash osm2map.sh
Downloading osmosis to /opt/osmosis.
...
Downloading mapwriter plugin /opt/osmosis.
...
Download and build successful finished.
osmosis usage:
/opt/osmosis/bin/osmosis --rx file=path-to-osm-file.osm --mw file=destination-path-map-file.map
Then you can begin to convert your own map-files with:
/opt/osmosis/bin/osmosis --rx file=path-to-osm-file.osm --mw file=destination-path-map-file.map
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. The following steps will guide you through the installation and configuration:
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.
We're using docker and docker-compose to run the FTP server.
Go through the official documentation in order to get both components installed.
Open map-file-download-center/docker-compose.yml and change the environment variables to your needs:
In this example, every file in /opt/ohdm/ will be shown in the android application. Make sure, that there are actually map-files in the directory you specified under volumes in the docker-compose.yml.
version: "3.3"
services:
vsftpd:
container_name: vsftpd
image: panubo/vsftpd
ports:
- "21:21"
- "4559-4564:4559-4564"
restart: always
environment:
FTP_USER: ohdm
FTP_PASSWORD: ohdm
FTP_USERS_ROOT:
network_mode: "host"
volumes:
- /opt/ohdm:/srv/ohdm
Now you can start the container with
docker-compose up
If successful, you should see
...
vsftpd | Received SIGINT or SIGTERM. Shutting down vsftpd
vsftpd | Running vsftpd
at the end of the output. Great, now you can begin to adjust the source code to point the app to your ftp server
Open the file app/src/main/java/de/htwBerlin/ois/Activities/MapDownloadActivity.java:
and change the parameter with the values you just used in the docker-compose file:
...
private static final String FTP_SERVER_IP = "";
private static final Integer FTP_PORT = 21;
private static final String FTP_USER = "";
private static final String FTP_PASSWORD = "";
...
Just install the application again on your device with Android Studio.
In order to host map-files on the FTP server, just copy the files to /opt/ohdm/
You then should see the listed files in the Maps tab.
You can start the container with docker-compose up -d in background.
Developed by: FalcoSuessgott
Project Link: Open Historical Data Map
Institution: HTW Berlin
Mail: info@ohdm.net