Great question! While Mapbox GL JS doesn't have a direct "label density" setting when initializing the map, you absolutely can adjust label collision behavior to cut down on how many labels appear—by modifying collision box sizes and related layer properties. Here's how to make it work:

1. Expand Label Collision Boxes with text-padding #

The core idea to reduce density is making collision detection stricter. A simple, effective way is to increase the text-padding layout property for your label layers. This adds extra space around each label's collision box, meaning labels need more room to avoid overlapping—so fewer will render at any given zoom level.

After your map loads, target specific label layers from the dark-v9 style and update their padding:

map.on('load', () => {
  // Adjust padding for large city labels
  map.setLayoutProperty('place-city-lg', 'text-padding', 25);
  // Adjust padding for medium city labels
  map.setLayoutProperty('place-city-md', 'text-padding', 20);
  // Adjust padding for primary road labels
  map.setLayoutProperty('road-label', 'text-padding', 15);
  
  // Repeat for other label layers (like place-city-sm, road-label-small) as needed
});

The higher the padding value, the larger the collision box, and the fewer labels will be displayed.

2. Prioritize Key Labels with text-optional #

Another handy property is text-optional. Setting this to true tells Mapbox GL JS that the layer's labels are non-critical, so the map will prioritize showing more important labels (like larger cities over small towns) when space is tight. This naturally reduces overall density while keeping essential information visible:

map.setLayoutProperty('place-city-sm', 'text-optional', true);

3. Note on Map Initialization #

There’s no global setting in the mapboxgl.Map constructor to adjust label density directly. All label tweaks happen after the map loads by modifying individual layer layout properties, as shown above. This gives you granular control over which label types you want to scale back.

Pro tip: You can find the exact layer IDs for dark-v9's labels using your browser's dev tools and the Mapbox Inspector tool—this helps you target exactly the labels you want to adjust.

内容的提问来源于stack exchange，提问作者Rodrigo Fava