User:Ff5722/How to create and host tilesets from GeoTIFF images
Jump to navigation Jump to search
This only needs to be done once.
- Install QGIS from https://qgis.org/en/site/forusers/download.html
- Install an local web server such as WampServer or XAMPP
- Follow the instructions here to set up TileServer-php to be hosted on your local server (so, place the tileserver folder in the 'www' or 'htdocs' folder of Wamp or XAMPP, for example C:\wamp64\www\tileserver\tileserver.php.
- Redirect your localhost domain to a virtual domain.  This is needed because JOSM doesn't accept background imagery hosted at localhost. Add a line 127.0.0.1 examplename.domain to your hosts file.
- Start the Apache server and go to the tileserver page (http://localhost/tileserver). Verify that your virtual domain is working, by going directly to examplename.domain/tileserver and not to localhost/tileserver.
- Right click the WMTS link on the right side and copy the URL. In JOSM add this URL as a WMTS server (for example http://ff5722.local/tileserver/wmts).
- Open QGIS and go to Plugins > Manage and install plugins. In the Plugins window, go to Settings and enable 'Show also experimental plugins'. Click reload repository. If you use QGIS3, install the Qtiles3 plugin by alexbruy. If you use QGIS2, install the Qtiles plugin by Nextgis.
- Open your GeoTIFF in QGIS or open the Sentinel-2 MTDxxxxxxxxxxx.xml file. You can open Sentinel-2 zips directly in QGis, to open the image layers, click the ZIP file in the file browser panel to the left, and open the last file in the ZIP.
- Go to Plugins > QTiles and open the QTiles window. Refer to the table below to see which settings to use.
- Rename the JSON file to metadata.json and place it in the same folder as the tiles. (like \tileserver\London\metadata.json)
- Start the local web server
- In JOSM, select your custom WMTS server and start tracing.
- If the tileset doesn't appear in the JOSM 'Select WMTS layer' window, you need to delete the WMTS cache. This is due to the way JOSM handles imagery. To enable the new layer, go to JOSM advanced preferences, and enter 'wmts' in the search field. Delete the value for 'mirror.http://yourdomain' You can also go to C:\Users\%USER%\AppData\Local\JOSM\cache and delete the cache for your tileserver.
|Tileset name||Name of area in tileset, cannot contain non-Latin script|
|Output||Directory: Should be your tileserver top level folder e.g. 'C:/wamp64/www/tileserver'|
|Extent||Choose 'layer extent' in most cases. Choose 'full extent' if you want to render multiple images as one tileset, for example connecting satellite imagery.|
|Zoom||Minimum zoom: 0|
Maximum zoom: 15 (or higher if using high-res images)
|Leave at default. You can choose to render tiles in JPG if storage is a concern. JPG tiles will show an annoying error message in JOSM though.|
|Make lines less jagged||Off, unnecessary for imagery|
|Use TMS convention||Leave at default (off)|
|Render tiles outside extents||I recommend turning this on. Renders whitespace around your data, makes it easy to find on the map, but will overlap if you use other layers.|
|Write .json metadata||Turn on (important)|
|Write overview image file||Leave at default (off)|
|Saving the tiles to an SSD instead of to a mechanical HDD greatly speeds up the process. You don't need a very powerful CPU, I use a Pentium G4560, and generating tiles for one Sentinel-2 snapshot of about 50x50 km up to zoom level 16 takes around 10 minutes.|
|You can also generate tiles for only part of a GeoTIFF image. To do this, in QGIS, choose from the menu Raster > Extraction > Clipper. Save as a new file (e.g. crop.tif). Then in the Qtiles window, select the cropped layer.|
|Although Qtiles is not multithreaded, you can still open multiple instances of Qtiles to render several tilesets simultanueously. Simply open the plugin again from the QGIS menu.|