This article explains the general concepts of picking a map style and adjusting it to your needs in the MapTiler Customize tool. You will find a glossary of map-related Customize functions at the end.
Choosing a map
After login to MapTiler Cloud you will be located in the Maps section. Click on the NEW MAP button to open the Map wizard with map styles categorized into groups. Read the description of each map if you are not sure which to pick.
You can click on the CUSTOMIZE button to adjust the map or on USE THIS MAP and have the map ready as it is for your applications.
The same process can be done in the Maps section by clicking on any map in the list.
If you are not sure what map is suitable for your use case, check the article Choose a map style or contact us via email.
MapTiler Customize is a new-generation online map editor. Focused on easy-to-understand UI, you don't need to be proficient in cartographic principles or JSON syntax in order to create stunning visuals. Customize runs on MapLibre GL JS.
There are four panels on the left, each specific to map styling.
- Quick edits (Alt+Q) - for easy adjustments of map color palette and fonts
- Layers (Alt+L) - for complex styling of individual or multiple layers, filtering data or writing JSON
- Settings (Alt+S) - for setting global map options such as languages, borders or initial position
- Data sources (Alt+D) - for adding, removing, or replacing data or checking data details
Map Style = a unique map, either one of MapTiler's default styles or your own style
MapLibre style/style.json = a JSON document that defines the visual appearance of a map - colors, layer order, data sources, etc. (every map style is a style.json); this is what you get when you download a map style
Layer = an entity in a map containing specific map features that are styled together (Road network); takes the data from a data source layer, optionally filters features, and defines how those features are styled
Block = a group of layers
Verticality = order of the layers in the map; the first one is rendered on top
Style/Data = style panel serves for map design/data panel handles filters, geometry, or type of visualization
Filter = specifies conditions on source data; only features that match the filter are displayed in the map
- Filter Logic: All = returns
trueif all the inputs are
- Filter Logic: Any = returns
trueif any of the inputs are
- Filter Logic: None = returns
trueif none of the inputs are
Attributes = information linked to the data that describes features and is used for filtering: class, admin_level, rank, name etc.
Layout properties = define how data for a layer is passed to the GPU; icon or text size, font, offset, visibility, text-field etc.
Paint properties = are applied later in the rendering process and happen synchronously: color, opacity, halo, width, etc.
Icon = properties for styling small images (icons) representing point data
Text = properties for styling text labels such as font, size, or justification
Fill = properties for styling fill of polygons such as color, opacity, or pattern
Outline = properties for styling lines or borders of polygons; color, opacity, width, or style (dash array)
Layout = influences the placement of features: anchor, padding, overlap, etc.
Effects = includes blur of lines
Default View = defines the initial position of the map with the zoom level, map center (latitude, longitude), tilt, and rotation angle
Font Fallback = a font to which your default font switches in case of unsupported characters (Arabic, Cyrillic etc.)
Data source = source of map features (tiles or other data formats); every layer needs to have one
Data layer = an entity in a data source containing specific map features
Geometry = encoding of geographic data, related to data representation; Polygon, LineString, Point etc.
Visualization = specifies the styling options; Polygon, Line, Point, Symbol, Heatmap etc.
Save = saves a map or your changes in the MapTiler Cloud interface
Publish = publishes your changes into production across all your apps where the map is embedded