1. Knowledge center
  2. eSpatial Troubleshooting

Map does not display 'Error - Failed to initialize WebGL'

There can be issues with certain combinations of video/graphic cards, browsers and Operating Systems. It is a requirement of Azure Maps which eSpatial uses as its core mapping component.

 

Troubleshooting steps for this error:

  1. Get latest browser version
  2. Test in another browser 
  3. Get latest video card drivers 
  4. Restart your device
  5. Go to: Chrome Settings -> System -> ensure "Use hardware acceleration when available" is enabled.
  6. Go to: chrome://flags/#ignore-gpu-blacklist and enable this option, restart device (restarting Chrome alone may not work with this change)
  7. Ensure that the Disable3DAPIs policy is not set for the browser. To check, enter chrome://policy/ into browser URL. See also: https://chromeenterprise.google/policies/?policy=Disable3DAPIs
  8. Go to: https://get.webgl.org/ in each browser. Do you see the see spinning cube?
  9. Go to: http://mapbox.github.io/mapbox-gl-supported/ Does a message saying 'Map GL JS is supported' appear?
  10. Go to: https://samples.azuremaps.com/map/detect-if-browser-is-supported - Does a map appear?
  11. If using Chrome, enter chrome://gpu in the nav bar, copy content of page and send to help@espatial.com 
  12. If using Safari on iPad,
    1. upgrade to the very latest iOS version
    2. If you cannot upgrade to the latest, please go to settings, Safari, Advanced, Experimental Features. Ensure WebGL 2.0 is Enabled, WebGL via Metal is Disabled