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 order 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, 

1. Go to Admin -> Map Overlays 
   (the user account will need the Map Overlays permission - contact DM if you cannot access map overlays)
2. Click Create in the top left
3. These options are presented
   1. Name
   2. URL
   3. Extension
   4. Default Opacity
   5. Minimum Zoom
   6. Maximum Zoom
   7. North Boundary
   8. South Boundary
   9. East Boundary 
   10. West Boundary
   11. 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. 

Troubleshooting

To troubleshoot a Map Overlay not loading

1. Navigate to the Map Overlay storage url
   1. Edit the Map Overlay that is having issues
   2. Lookup the url where the maps are stored and check for any error messages.
2. Ensure the cloud storage the Map Overlay is stored is not locked/disabled.
3. If no issues are identified on steps 1 and 2, Contact Support.