Map Tiles Are Not Loading

Use this when

The GPS map panel shows your track line but the background map is blank, grey, or shows broken tile squares.

Common reasons

• No internet connection — HumVision fetches map tiles live from external tile servers. There is no built-in offline cache.
• MapTiler tile styles require an API key — Street Map, Outdoor Map, Adaptive Map, Satellite with Labels, and Hybrid all call the MapTiler API. If the app was built without a valid key, those styles return no tiles.
• Tile server is temporarily down — Carto, MapTiler, OpenStreetMap, ESRI (Satellite), and OpenTopoMap are separate services. Any one of them can be unavailable for short periods.
• Firewall or proxy is blocking tile requests — Corporate or school networks sometimes block requests to CDN hostnames like basemaps.cartocdn.com, api.maptiler.com, or tile.openstreetmap.org.
• Map container did not resize — Collapsing the sidebar can leave blank strips at the edge until the map repaints.

How to check

1. Open any web browser on the same machine and load https://www.openstreetmap.org. If that page fails, the problem is your internet connection, not the app.
2. Note which map style is selected in Settings > Map Style. If it is anything other than Clean Map or OpenStreetMap, it uses the MapTiler API.
3. Open the app's developer console (View > Toggle Developer Tools on Windows/Linux, or via the menu on macOS) and look for network errors on requests to tile server hostnames.

What to try next

1. Switch to Clean Map in Settings > Map Style. Clean Map uses the Carto CDN and does not need a MapTiler key. OpenStreetMap is a second key-free fallback.
2. Check your network connection and retry. Reconnect Wi-Fi or switch from a metered connection to a faster one.
3. If you are on a corporate network, ask your IT team to allow outbound HTTPS to *.cartocdn.com, *.maptiler.com, *.tile.openstreetmap.org, and server.arcgisonline.com.
4. Try collapsing and expanding the sidebar. This forces the map to repaint the full viewport.
5. Restart the app. A stale tile request can occasionally block new ones.

If it still does not work

If tiles fail for all styles on a working internet connection, contact support at support@gethumvision.com and include the network errors from the developer console.