MAPBOX_STYLE - Detailed description

Overview

Parameter:MAPBOX_STYLE
Category: OpenStreetMaps
Default value: streets-v11
Product: eTASK.Other (OpenStreetMaps)

What does this parameter do?

This parameter defines the modern Mapbox map style for all OpenStreetMap maps displayed in the eTASK FM portal. Unlike MAPBOX_MAP_ID, which uses older map IDs, MAPBOX_STYLE utilizes the newer Mapbox API and provides access to current map styles with versioned notation (e.g., streets-v11).

What is this parameter used for?

• Modern map display: Access to the latest Mapbox map styles with current versions

• Consistent map styles: Uniform visual appearance of all maps in the portal

• Navigation optimization: Special styles for navigation scenarios (day/night modes)

• Future-proof configuration: Use of current Mapbox API standards

• Advanced design options: Access to specialized styles such as Outdoor or Satellite Hybrid

Technical Details (for Administrators)

Format: Text string (Mapbox style name with version number)
Default value: streets-v11

Valid values:

• streets-v11 = Modern street map with detailed information (default)

• outdoors-v11 = Optimized for outdoor activities and topography

• light-v10 = Light, minimalist map with a simplified design

• dark-v10 = Dark variant for modern user interfaces

• satellite-v9 = Pure satellite image view

• satellite-streets-v11 = Combination of satellite imagery and street information

• navigation-day-v1 = Optimized for navigation in daylight

• navigation-night-v1 = Optimized for navigation in the dark

Important notes:

• This parameter overrides MAPBOX_MAP_ID if it is set

• Version numbers are important for compatibility (e.g., v11, v10, v9)

• Changes will be visible the next time a map is loaded

• Uses the modern Mapbox Styles API

• Further information: https://docs.mapbox.com/api/maps/styles/

Interaction with other parameters:

• MAPBOX_ACCESS_TOKEN: Mandatory for map rendering

• MAPBOX_MAP_ID: Is overridden if MAPBOX_STYLE is set (MAPBOX_STYLE takes precedence)

• MAPQUEST_APP_KEY: Required for geocoding and address search

When should you change this value?

Change the value (select a different style) if:

• You want to use the latest Mapbox map styles

• MAPBOX_MAP_ID uses outdated styles that are no longer supported

• You want specific navigation optimizations (day/night modes)

• Outdoor applications or topographic details are important

• Corporate design requires a specific look

• Mapbox has released new style versions that you want to use

Keep default value (streets-v11) if:

• The current map display meets your requirements

• There are no special design or functional requirements

• You want to migrate from MAPBOX_MAP_ID and test the default

• A proven and stable map display is desired

Important Notes

1. Priority over MAPBOX_MAP_ID
   If MAPBOX_STYLE is set, MAPBOX_MAP_ID is ignored. MAPBOX_STYLE overrides the older configuration. Preferably use MAPBOX_STYLE for new installations.

2. Note
   versioning The version numbers (v11, v10, v9) are part of the style name and are important for compatibility. Mapbox updates styles regularly. Check the Mapbox documentation for the latest available versions.

3. Test Before Production First
   test new styles in a test environment. Different styles may have varying readability and information density.

4. Navigation styles
   The styles navigation-day-v1 and navigation-night-v1 are specifically optimized for navigation applications and offer increased contrast for better orientation.

Security

Does changing this parameter affect security?

No, this parameter has no direct impact on security.

Practical example

Initial situation: A facility management company is currently using the outdated MAPBOX_MAP_ID parameter with the value mapbox.light. The IT department wants to migrate to the modern Mapbox Styles API while retaining a contemporary, light-colored map design. Additionally, it has been reported that the map display on mobile devices is not optimal.

Configuration: The administrator replaces the old configuration with the modern MAPBOX_STYLE parameter:

The old MAPBOX_MAP_ID configuration can be removed or retained (it is automatically ignored if MAPBOX_STYLE is set).

After the change:

• All maps now use the modern light-v10 style of the current Mapbox API

• The map display is optimized and up-to-date on all devices

• Future Mapbox updates will be automatically deployed for the v10 version

• Readability on mobile devices has been significantly improved

• The portal now uses the recommended modern API version

Result: The migration to MAPBOX_STYLE has been successfully completed. The system uses modern, well-maintained map styles. Users benefit from improved display on all devices. Maintainability has increased, as only the current API standard is now used.

Alternative scenarios:

Scenario A - Outdoor Facility Management:

• Company manages parks, sports facilities, and outdoor areas

• MAPBOX_STYLE = outdoors-v11

• Advantage: Topographic details, paths, and contour lines are clearly visible

• Ideal for terrain and outdoor area management

Scenario B – Night Operations:

• 24/7 operation with night shifts

• MAPBOX_STYLE = navigation-night-v1

• Advantage: Reduced glare, high contrast in low-light conditions

• Perfect for security services and night operations

Recommended setting

For standard installations:streets-v11(modern street map)

Reason:

• Most up-to-date and best-maintained street map style

• Balanced information density for office applications

• Good readability on all devices

• Regular updates by Mapbox

• Proven standard with broad compatibility

For specific requirements: - Minimalist design: light-v10 - Dark portal design: dark-v10 - Outdoor/Terrain: outdoors-v11 - Detailed satellite imagery: satellite-streets-v11 - Navigation applications: navigation-day-v1 or navigation-night-v1

Migration from MAPBOX_MAP_ID: If you are currently using MAPBOX_MAP_ID, migrate to MAPBOX_STYLE: - mapbox.streets → streets-v11 - mapbox.light → light-v10 - mapbox.dark → dark-v10 - mapbox.satellite → satellite-v9 - mapbox.outdoors → outdoors-v11