LuciadRIA was released in 2012 with a 2D map based on a HTML5 Canvas. In 2016, a 2D/3D map was introduced that takes advantage of the hardware acceleration available in most browsers.

Moving forward, our focus solely lies with the hardware-accelerated RIAMap. It offers all the capabilities of a non-hardware-accelerated Map, and brings much more to the table.

This document explains how we are phasing out the non-hardware-accelerated map, and how you can easily modify your application to use the RIAMap.

Phasing out the non-hardware-accelerated Map

The non-hardware-accelerated Map was deprecated with LuciadRIA 2024.0. The 2025.0 release was the last release supporting it. In LuciadRIA 2026.0, we removed the non-hardware-accelerated Map. All maps are now hardware-accelerated.

Switching to RIAMap in your application

You can switch to RIAMap by changing the constructor call of your Map.

  • If you’re using LuciadRIA 2026.0 or later, replace:

    import {Map} from "@luciad/ria/view/Map.js";

const map = new Map(domNode, options);

    with:

    import {RIAMap} from "@luciad/ria/view/RIAMap.js";

const map = new RIAMap(domNode, options);

  • If you’re using LuciadRIA 2025.0 or earlier, replace the usage of Map with: 

    import {WebGLMap} from "@luciad/ria/view/WebGLMap.js";

const map = new WebGLMap(domNode, options);

The RIAMap API is a superset of the Map API, so no further changes are necessary.

See LuciadRIA benefits for the features available to you when you use RIAMap.

You can find the WebGPU system requirements here.

We plan to keep the Map and WebGLMap type in the API in LuciadRIA 2026.0, as an alias for RIAMap. That way, you won’t have to update all usages of the Map type and WebGLMap type to RIAMap immediately, as an argument type in method signatures for example. Regardless, we recommend updating your code to use RIAMap.

Upgrade considerations

For completeness, we list the upgrade considerations:

Aside from the items listed above, RIAMap supports everything that a Map could do, and more.

If you have any questions or feedback, please contact the Luciad Product Management team at product.management.gsp@hexagon.com.