mousemove with two layers on top of each other (event propagation)

Nobody has claimed this yet.

2.8.2

### Question

The closest to my question are: https://stackoverflow.com/questions/50294242/mapbox-gl-js-overlapping-layers-and-mouse-event-handling and https://stackoverflow.com/questions/48555583/how-to-ignore-mouse-events-on-a-mapbox-layer/ - but they don't answer it.

I have two layers, let's imagine one is for a country, and another is for a city. Both of them a handled like this:

// CountryLayer.js
map.on("mousemove", "country-layer", e => {
// show info about the country
featureProps = e.features[0] // display some notification from the props
...

// CityLayer.js
map.on("mousemove", "city-layer", e => {
// show info about the city
featureProps = e.features[0] // display some notification from the props
...

It's done in different components. But when I mouseover `city-layer` mapbox thinks that I'm still "mousemoving" on top of the `country-layer` as well, so I get two notifications from separate components, where I need only one - in that case from the `city-layer` cause it's on top of `country-layer`.

Handling the `mousemove` without layerId in one place is gonna be a mess and breaks all the good rules about programming. Creating external "event manager" which will track whether I'm hovering the city and if is so will remove `mousemove` event from `country-layer` - is complex. I didn't find any good alternatives and there 0 total information about it in documentation. At least, I would be glad to disable pointer events for a layer like this:

map.on("mousemove", "city-layer", e => {
map.getLayer("country-layer").setStyle({ "pointer-events": false })
featureProps = e.features[0]
...

or something like this. Is it possible? Is there more adequate way around it?

### Links to related documentation

https://docs.mapbox.com/mapbox-gl-js/api/map/#map.event:mousemove
https://docs.mapbox.com/mapbox-gl-js/api/map/#map#on

Start with the linked Map event:mousemove and Map#on documentation, then reproduce the two-layer example from the issue. Determine whether overlapping layer handlers can be ordered or stopped independently, and document or implement the supported behavior. Done means the city-layer interaction no longer produces the unwanted country-layer notification, with the behavior explained in the relevant documentation.

Written by the indexing model from the issue text.