Custom Map Overlays in TG
Table of Contents
Telematics Guru can support Custom Map Overlays.
Map overlays will be displayed on the following views:
- TG Web
- Live View
- Trip History Map View
- Asset Daily Coverage Map
- TG App
- Live View
- Overlays are disabled by default, and must be enabled on the Settings page within the app
Often users such as mine sites wish to be able to overlay aerial images, or more up-to-date maps onto a tracking platform.
Aerial images make locating devices and seeing the actual position relative to site features simple.
Often in newer areas, the Google Maps view will not update quickly enough for requirements so the option to overlay images is a key feature.
To use this feature, the Map Overlays functionality must be enabled for your organisation.
Config Overview
Tiled Map Format
In ordToer to set up map overlays in Telematics Guru, you must first create your map files in Tiled Map Format, and host the tiles in a publicly accessible webserver.
To create the tiles you can use services such as Maptiler, QGIS or ArcGIS
Tiles are essentially the overlay image at various zoom levels - so when you zoom in/out of the map the overlay will scale accordingly and display correctly.
Hosting
Host your files somewhere such as Amazon S3 Storage
The folder the files are stored in must be publicly accessible - to test this, open the URL in an incognito/private browsing window. If you cannot see the tile files - it is not publicly accessible and cannot be used.
Telematics Guru will pull the Tile Files from your configured server and overlay them on the map.
Set-Up
To set up a map overlay,
- Go to Admin -> Map Overlays
(the user account will need the Map Overlays permission - contact DM if you cannot access map overlays) - Click Create in the top left
- These options are presented
- Name
- URL
- Extension
- Default Opacity
- Minimum Zoom
- Maximum Zoom
- North Boundary
- South Boundary
- East Boundary
- West Boundary
- Hidden by Default
Mouse over the tooltip near each option for more information.
Overlays are added to each organisation. If you need the same overlay on multiple organisations, you must create it per organisation.