Map styles 
The built-in map styles defined in the Client JS library are exposed by the SDK so that they can easily be used.
MapTiler maintains built-in styles exposed as shorthand from the SDK. These styles simplify map creation by eliminating extra code and ensuring you always use the latest versions.
This has several advantages:
- Automatic updates: Style updates apply automatically without requiring code changes.
- Shorter syntax: Shorthands are easier to remember than full style URLs, and the SDK automatically handles your API key.
- Code completion: Autocomplete reduces typos and configuration errors.
Each built-in style serves a specific purpose (such as street navigation, outdoor adventures, or minimalist dashboards) and includes variants with different color schemes (such as light or dark) that maintain the same layer structure and detail.
ReferenceMapStyle
A reference style defines the purpose, information density, and guidelines for a map’s design, such as street navigation or outdoor adventures.
The MapStyle.REFERENCE_MAP_STYLE is an instance of the ReferenceMapStyle class (with a proxy layer).
Example
MapStyle.STREETS
|
|
The classic default style, perfect for urban areas. |
MapStyle.SATELLITE
|
|
High resolution satellite images. |
MapStyle.HYBRID
|
|
High resolution satellite with labels, landmarks, roads ways and political borders. |
MapStyle.OUTDOOR
|
|
A solid hiking companion, with peaks, parks, isolines and more. |
MapStyle.WINTER
|
|
A map for developing skiing, snowboarding and other winter activities and adventures. |
MapStyle.BASE
|
|
A minimalist alternative to STREETS, with a touch of flat design. |
API reference
MapStyleVariant
Each reference style offers a range of variants that contain the same level of information and serve the same purpose, but use different color schemes.
The MapStyle.REFERENCE_MAP_STYLE.MAP_STYLE_VARIANT is an instance of the MapStyleVariant class.
The proxy layer on top of each ReferenceMapStyle instance catches nonexistent variants and falls back to the default style.
For example, MapStyle.STREETS is a proxied instance of ReferenceMapStyle. To use the dark variant (an instance of MapStyleVariant), use MapStyle.STREETS.DARK. If you request a nonexistent variant, such as MapStyle.STREETS.INDIGO, it falls back to MapStyle.STREETS.DEFAULT. The benefit of using a proxy instead of a standard getter is this dynamic property resolution.
Example
MapStyle.DATAVIZ.DARK
|
|
A minimalist style for data visualization. Also available in color and light mode. |
MapStyle.DATAVIZ.LIGHT
|
|
A minimalist style for data visualization. Also available in color and dark mode. |
MapStyle.BRIGHT.PASTEL
|
|
A minimalist style for high contrast navigation. Also available in color, dark and light mode. |
API reference
Map styles list
MapTiler provides reference styles as well as variants for each. Here is the full list: