WebGL (short for Web Graphics Library) is a JavaScript API used to render interactive 2D and 3D graphics within compatible web browsers. The onX Hunt Web Map utilizes WebGL 2.0 in conjunction with MapBox.
If you access the Web Map and see an error message indicating that your web browser doesn't support WebGL2, you'll need to update your browser to the latest available version or use a different browser entirely.
If you'd prefer to use a specific browser, you may be able to adjust your browser settings to fix the problem.
Note: Web browsers with increased security and privacy features such as Brave or Duck Duck Go are unsupported. Users of either browser experiencing Web Map performance issues may need to utilize a different one for full functionality.
Table of Contents:
- How to check if your Web Browser supports WebGL2
- Fixing the MapBox WebGL2 error in Google Chrome
- Fixing the MapBox WebGL2 error in Mozilla Firefox
- Fixing the MapBox WebGL2 error in Safari
- Fixing the MapBox WebGL2 error in Microsoft Edge
- Fixing the MapBox WebGL2 error in Internet Explorer
How to check if your Web Browser supports WebGL2
Click here for the WebGL2 testing site.
If you see the cube below spinning on the testing site, your web browser supports WebGL2.
If you see the spinning cube and still have issues viewing the Web Map, try the following:
- Clear your browsing history and cache.
- Disable or pause any active VPNs, Ad-blockers, or other internet security features and/or whitelist our site.
If you don't see the spinning cube on the testing site, please switch to a different browser or follow the instructions below to re-configure your browser settings.
Fixing the MapBox WebGL2 error in Google Chrome
We recommend using Google Chrome to access the Web Map.
If you've updated to the latest version of Google Chrome and still see the same error message, please try the following steps:
- Click the three vertical dots in the upper right-hand corner of your browser.
- Click "Settings."
- On the left-hand side of the screen, click "System."
- Turn on "Use graphics acceleration when available."
- Click "Relaunch." Your browser will close and re-open automatically.
If the above steps don't work to fix the problem, we can try an experimental feature in Google Chrome. Keep in mind this solution may not always work.
- Type "chrome://flags" in your browser address bar and press "Enter."
- At the top of the screen, search for "Choose ANGLE graphics backend."
- If you have a Windows computer, select "OpenGL" from the drop-down menu.
- If you have a Mac computer, select "Metal" from the drop-down menu.
Fixing the MapBox WebGL2 error in Mozilla Firefox
- Go to about:config in your address bar.
- Search for webgl.force-enabled and make sure this preference is set to "true." If it's currently set to false, click the toggle icon on the far right to change the value to true.
- Search for webgl.disabled and make sure this preference is set to false. If it is currently set to true, click the toggle icon on the far right to change the value to false.
-
Search for webgl.enable-webgl and make sure this preference is set to true. If it is set to false, click the reverse icon to the right to set to true.
- Restart Firefox.
Fixing the MapBox WebGL2 error in Safari
While WebGL should be enabled by default on Safari for all recent browser versions, there may be some circumstances where you will need to manually enable this setting:
Please note that the following steps will only apply if WebGL has been disabled from your browser.
-
From the Safari menu bar at the top of your screen, click Safari > Settings
-
Select the Websites tab.
-
Select WebGL from the list on the left side of the window. This will only be present if WebGL has been disabled.
-
If you see webmap.onxmaps.com listed on the right, select Allow from the drop-down menu
-
If you do not see webmap.onxmaps.com listed on the right, look for When visiting other websites in the lower-right corner of the window, and select either Ask or Allow from the drop-down menu.
-
Restart Safari to apply the new settings.
If you are unable to load the page after taking the above steps, we recommend trying the following:
-
-
Open the webmap.onxmaps.com website.
-
From the Safari menu bar at the top of your screen, click Safari then click Settings
-
Select the Advanced tab.
-
Check the box to Show Develop menu in menu bar.
-
From the menu bar, click Develop then select Experimental features.
-
Click to enable WebGL.
-
Restart Safari to apply the new settings
-
Fixing the MapBox WebGL2 error in Microsoft Edge
- Click the overflow menu (three dots) in the upper-right corner, then click Settings.
- Click System on the left.
- Turn on Use hardware acceleration when available.
- Click Restart to apply the new settings.
Fixing the MapBox WebGL2 error in Internet Explorer
You will need Internet Explorer version 11 or later. If you are running Windows 8 or Windows 7, update your Internet Explorer to version 11. Click here to update your version of Internet Explorer.
Still not working?
If using a different browser or changing your current browser's settings doesn't fix the problem, please let us know. Click here to learn how to contact onX customer support.