Raster maps installation

This guide shows how to use an image file as a map in GpsGate onPrem.

To use a bitmap image as a map in GpsGate you need to convert it to the MapData format with GpsTools Studio.

MapData consists of several tiles and one XML-document collected in a folder and is usually the same thing as a Zoom-level when used in GpsGate.

  • Tile is a small picture consisting of a 256*256 .PNG-file

Installation steps

1. Download GpsTools Studio here.

2. Install GpsTools Studio on a Windows-compatible PC.blog_import_images_001.png


3. Find and execute GpsTools Studio


4. Once the application is running, you need to click in the white area to load an image. Only BMPGIFJPGTIF, and PNG are supported.


5. Here you have to input some basic data.

Screenshot 2024-03-11 at 15.11.28.png

6. Follow the Scaling Wizard. To know which options and standards might suit your needs better, we recommend you contact your map supplier and set the values according to your regional settings. 
You need to select 3 coordinate-points on the map, the further apart they are the better the accuracy will be. For each point, you must enter the scaling coordinates that comply with the selected points.



7. Once you have determined the 3 points, you will see a message.

Then select Save MapLib as in the File menu, and save this file in your computer (you can retrieve your saved settings later if you load this file).

8. Select the Export Tiles (for GpsGate) in the File menu and save the map to a destination of your choice, preferably the same destination as any other maps you wish to create. 

Screenshot 2024-03-11 at 15.15.38.png

9. The Map Data folder you have created should contain numerous tiles in the png format and an XML file. Put the whole folder into the Maps folder in your GpsGate installation, typically: C:\GpsGateServer\Maps\ 
Screenshot 2024-03-11 at 15.18.28.png

10. Now we need to go to the application under: Site Admin - Maps & Geocoders. Press on +Custom map button

Screenshot 2024-03-11 at 15.21.05.png
11. Select the custom map, and press on Include. Save the new Custom map from the button: Save.

Screenshot 2024-04-22 at 11.45.48.png

12. Go to the application Privileges and FeaturesMaps & Geocoders → enable the custom map

13. Click on Save to save your application settings.

Screenshot 2024-04-22 at 11.46.30.png

14. Read more information how to choose a map in an application.