JTileDownloader

From OpenStreetMap Wiki

Jump to: navigation, search

JTileDownloader is a Java application for downloading OSM tiles. You can paste a 'Permlink' to the application, select a radius in km and zoomlevel, select a renderer and download the tiles.

The application is free and the source code is available under the GPL.

General Information

I have written this small program, because OSMtiledownloader does not support pasting an OSM-URL for downloading the tile files.

Currently there are no error/info messages shown if something went wrong or some values were not entered correctly. This will be fixed in future versions.

Use the discussion tab for reporting bugs and adding feature requests

As I'm very busy at the moment, I do not have time to include new features to the JTileDownloader

Developer : fma
Target platform : Windows, Linux, Mac, ...
Dev. language : Java
License Type : GPLv3, see COPYING file for more information

Screenshots

Screenshots

Description

Main

OutputZoomLevel: Select the zoom level for download
OutputZoomLevels: Enter the zoom levels to download as comma seperated string (ex. 12,13,14). If the zoom levels are specified in this way, the selected zoom level in the combo box 'OutputZoomLevel' is ignored
Alt. Tileserver: Here you can specify another Tileserver if the one you prefer is not in the list above this field.
Outputfolder: Specify here were the downloaded files should be save. If nothing is entered, the downloaded tiles will be stored in a subfolder 'tiles' of the program directory. The folder can be specified as relative or absolute path. Some examples for Windows: myTiles or C:\osm\myTiles Some examples for Linux: osm/tiles or /home/myUser/data/myTiles
Number Tiles: Informs about the complete number of tiles selected for download/export.
Download Button: Downloads the files to the specified folder.
Export Button: Stores a list of all files in a text file called 'export.txt' located under the specified output folder.

Paste URL (Square)

Paste URL: Paste here the URL (Permlink) from OSM. The application will extract the Lat and Lon values from the link.
Radius: Enter here the radius from were the tiles should be downloaded (bounding rectangle). As the calculation of the min and max values of the tiles is based on a 'flat' earth, the radius in km may differ from the real world. (Perhaps I will do a better calculation later)

BoundingBox (Lat/Lon)

Select a area to download specified by Latitude/Longitude

Min. Latitude: Minimum Latitude (ex. 48.3)
Max. Latitude: Maximum Latitude (ex. 48.9)
Min. Longitude: Minimum Longitude (ex 13.5)
Max. Longitude: Maximum Longitude (ex 13.9)

BoundingBox (X/Y)

Select a area to download specified by X/Y tile numbers

Min. X: Minimum X Tile Number (ex. 4000)
Max. X: Maximum X Tile Number (ex. 4010)
Min. Y: Minimum Y Tile Number (ex. 1200)
Max. Y: Maximum Y Tile Number (ex. 1230)

Update Tiles

Provides functionality to update existing tiles. Folder and tile server are taken from Main tab. Just press search and the table is filled with existing zoom levels. Select zoom level(s) and press update button. The tiles get updated.

Options

Wait Options

If this is enabled, the JTileDownloader will wait after the specified amount of tiles for the specified seconds before continue downloading the tiles. This option should be enabled if you download a huge amount of tile files to prevent overloading the tile server.

Tile Preview

Tile Preview: If this is enabled, the last downloaded tile is shown
Auto Close: Closes the tile preview window automatically after download was completed

Network

Proxy Settings

Enable this settings if you want to connect through a proxy server.

Install

Just download the .zip file and extract it somewhere on your PC.

Starting the application

Installed java version >= 1.5.0 is required

To start the application, just doubleclick/click (depending on operating system) on the downloaded .jar file.

Additionally start the application with java -jar [NameOfDownloadedFile] (eg. java -jar JTileDownloader-0-4-0.jar)

java -jar JTileDownloader-0-4-0.jar

Use the command line interface

java -jar JTileDownloader-0-4-0.jar dl=tilesUrlSquare.xml
java -jar JTileDownloader-0-4-0.jar dl=tilesBBoxLatLon.xml

example for tilesUrlSquare.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="Type">UrlSquare</entry>
<entry key="OutputLocation">C:\data\JTileDownloader\tiles</entry>
<entry key="PasteUrl">http://www.openstreetmap.org/?lat=47.777&lon=13.322&zoom=11&layers=B000TTF</entry>
<entry key="TileServer">http://tah.openstreetmap.org/Tiles/tile/</entry>
<entry key="OutputZoomLevel">11</entry>
<entry key="Radius">20</entry>
</properties>

example for tilesBBoxLatLon.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="Type">BBoxLatLon</entry>
<entry key="OutputLocation">tiles</entry>
<entry key="TileServer">http://tah.openstreetmap.org/Tiles/tile/</entry>
<entry key="MaxLat">48.2</entry>
<entry key="MaxLon">12.86</entry>
<entry key="MinLat">48.11</entry>
<entry key="OutputZoomLevel">8,9,10,11,12</entry>
<entry key="MinLon">12.77</entry>
</properties>

application specific settings may be set via appConfig.xml (file has to be in the same directory as the .jar file) example:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="WaitSeconds">10</entry>
<entry key="ShowTilePreview">true</entry>
<entry key="UseProxyServer">false</entry>
<entry key="WaitAfterNrTiles">true</entry>
<entry key="ProxyServer"></entry>
<entry key="WaitNrTiles">50</entry>
<entry key="ProxyServerPort"></entry>
<entry key="ProxyServerUser"></entry>
<entry key="AutoCloseTilePreview">true</entry>
<entry key="UseProxyServerAuth">false</entry>
<entry key="OverwriteExistingFiles">true</entry>
</properties>

Releases

Planned for next version

fixed bugs B3, B6
- (B3) proxy authorization doesn't work
- (B6) 'Update Tiles' is not working.
added requested feature R12, R13, R14
- (R12) Download Tiles along a GPX-File with a corridor of "x km" on each side.
- (R13) Could "Overwrite existing files" be split into "always" and "if changed"?
- (R14) Update tiles should not redownload all files. Better only update tiles which are older than a specific date