#10225: Enhance UX for simple 3D navigation in touch devices [Implementation via Config-level]

[mahmoudadel54]

Description

In this PR, the required enhancements are implemented but within the config-level by adding some cfg for cesium mapOptions to enhance UX of navigation.
In includes:

• Handle disable tilt effect
• Handle enabling zoom limits max, min or both
• Handle enabling fixing orientation of the map scene
• Handle enabling hiding the compass UI widget [will disable tilt effect as well]
• Handling quick reset to the initial camera scene stored into map object

Please check if the PR fulfills these requirements

• The commit message follows our guidelines: https://github.com/geosolutions-it/MapStore2/blob/master/CONTRIBUTING.md
• Tests for the changes have been added (for bug fixes / features)
• Docs have been added / updated (for bug fixes / features)

What kind of change does this PR introduce? (check one with "x", remove the others)

• Bugfix
• Feature
• Code style update (formatting, local variables)
• Refactoring (no functional changes, no api changes)
• Build related changes
• CI related changes
• Other... Please describe:

Issue

#10225
What is the current behavior?
#10225

Breaking change

Does this PR introduce a breaking change? (check one with "x", remove the other)

• Yes, and I documented them in migration notes
• No

Other useful information

There are 2 notes need to highlighted:
1- For the point Quick reset of the 3D map view (the camera view) to restore the initial state, I have checked the implementation of zoomToExtent button and I found out as an enhancement for 3D mode only, we can pass the viewerOptions object - that includes orientation and destination objects - to the zoomTo action which will do the same required functionality.

But If the required logic is keeping zoomTo extent implementation as it is currently and extending the functionality by adding the new functionality in a separate place, it is Ok.

2- For the point of fix camera orientation limits and/or fixed camera orientation, When I enable fix camera orientation enableFixedOrientation: true and disableTilt = true, the tilt doesn't disable.
It enables the tilt effect by default. so there will be conflict between disabling tilt and fix camera orientation.

[mahmoudadel54]

Hi
These are some simple demos demonstrating the UI implementation. I add the configuration into localConfig.json file into defaultMapOptions object --> cesium -->

1- configure enableFixedOrientation: true

enableFixedOrientation.by.true.demo.mp4

2- configure disableTilt: true

disable.tilt.by.true.demo.mp4

3- configure hideCompass: true

hideCompass.by.true.demo.mp4

4- configure enableQuickResetTo3DView: true

enableQuickResetTo3DView.by.true.demo.mp4

5- configure zoomLimits: { "min": 20000, "max": 20000000 }

zoomLimits.min.and.max.demo.mp4

[allyoucanmap]

@ElenaGallo please test on dev and let us know if we can backport to 2024.01.xx, thanks

[mahmoudadel54]

@ElenaGallo please test on dev and let us know if we can backport to 2024.01.xx, thanks

Hi @ElenaGallo

The results of this PR you can test [they are just 2 things]:

• maximumZoomDistance, minimumZoomDistance properties can be appended into mapOptions in localConfig and you can see its effect
• zoom to initial view [zoomToExtent button] in the bottom navigation toolbar, you can see the difference in 3D mode

For the rest points mentioned on the issue description, they may be in separate future issues.

[ElenaGallo]

Test passed, @mahmoudadel54 please backport to 2024.01.xx. Thanks