wiki:Styles

Languages:

JOSM Map Styles

source:trunk/images/dialogs/mapstyle.png The JOSM map display can be easily customized with different styles. Many styles are included with JOSM by default.

There are base styles (e.g. JOSM standard or Potlatch 2) that cover a wide range of features each. They can be combined with add-on styles that cover more special topics. See the available styles list below.

Further customization is possible via style options or by creating your own style.

Choose styles

JOSM has three lists of map styles: available styles (all styles from the style repository) → active styles (your favourites) → ☑ chosen styles (actually used for the map painting).

JOSM comes with some styles being in the "active styles" list by default. You can choose styles from this list of "active styles" to be actually used for the map painting by clicking the check box (☑) at the desired style's line

Note that, unless you are working with add-on styles, likely you want to have only one style ☑ checked at a time.

Activating more styles

How to add a map paint style

Instructions:

  1. open the Map Paint Styles Preferences by either
    • clicking the source:trunk/images/dialogs/mappaintpreference.png Settings button in the map style dialog (shown in the animation) or
    • via "View" menu → "Map paint styles" → "Map paint preferences" or
    • (less comfortable) via the general preferences window (Menu EditPreferencessource:trunk/images/preferences/map.png Map Settings (3rd button on the left) → Map Paint Styles (2nd tab))
  2. select a style in the (left) list of "available styles"
  3. activate it by clicking the source:trunk/images/preferences/activate-right.png blue right arrow button in the centre
  4. exit and confirm by clicking the OK button

Example: Let's assume that you want to add maxspeed=* values to osm, then you probably will make use of the style Maxspeed (which displays the value of maxspeed on roads with different colors). The screencast/animation on the right side (click to enlarge) shows how to add this style to your list of "active styles".

Adding own styles

You can add own styles (from any URL/file) to the list of active styles – for example a styles file which you have created yourself. Just click the source:trunk/images/dialogs/add.png plus sign on the right and enter either path and filename or URL of your style file.

Available styles list

short descriptionauthordescriptionversion
Coloured Addresses simon04 Style to ease mapping of addresses by colouring streets and houses More details
Iceland Ævar Arnfjörð Bjarmason Custom JOSM mappaint style for Iceland 0.1
icon SeaMap FreieTonne FreieTonne Seemap/ Seamarks from Project FreieTonne More details 20141024112048
Hide nodes Felis Pimeja Simple style to hide nodes in JOSM (may be handy to observe objects on low levels) 1
icon HDM HOT (Humanitarian OpenStreetMap Team) Humanitarian Data Model focused style. More details 0.0.1
Mapnik (true) MapCSS variant of the OSM Mapnik style (as close as possible to the original). It is not very suitable for real mapping in an editor because nodes and lines without a style are hidden and opaque areas may cover each other. This file is optimized for JOSM and may need some minor changes to work properly with other MapCSS implementations. 0.1
icon NaPTAN bus stops Vclaw Highlight bus stops (and taxi ranks) from Naptan import (UK), and whether they have been verified 0.1_2011-05-16
icon OpenAviationMap Morten Olsen Lysgaard OpenAviationMap styling of aviation related data. More details 0.0.2
OpenSeaMap OpenSeaMap Seamarks for OpenSeaMap More details 2011-02-13
Wheelchair Routing Attributes Michael Maier (species@osm) A Style for highlighting wheelchair-relevant Tags 1.0.3
Address Tags Validator Antisida, CupIvan, Felis Pimeja, Zverik Coloring of buildings with or without addr:street, addr:housenumber 1.15_2014-12-08
BesideTheRoad_Speed kudrdima Visualization of traffic signs, road characteristics, some of the road infrastructure, traffic restrictions and prohibitions More details 0.7_2011-09-28
British map overlay Ulf Lamping Special rules to take differences in the british area into account (e.g. traffic signs). 1.2_2011-02-25
Coloured Buildings.de geozeisig Style to classify buildings (german) More details 1.012_2014-04-01
Coloured Postcode geozeisig Style to ease mapping of Postcode by colouring streets and houses and nodes More details 2.15_2014-04-22
icon Coloured Streets geozeisig, Klumbumbus Colouring of buildings, address nodes and streets with the same street name in the same colour. Makes working with addresses a lot easier. Check out the linked page to read how to change some settings of this mappaint style. Min. JOSM version is 7480. More details 3.41.96_2014-12-18
Coloured Suburb geozeisig Coloring of buildings with addr:suburb depending on a CRC- algorithmus More details 2.9_2014-04-26
Conscriptionnumbers/streetnumbers jose1711 Displays addresses using Czech/Slovak address system More details 0.2.2_2014-12-19
Cycleways cmuelle8 Standalone style to visualize cycleway=* and bicycle=* of objects, fade everything else. Please turn off JOSM internal style to use it. More details 1.6_2014-06-13
icon FIXME Highlight Warnings pierzen This MapCSS style highlights ways/Polygons that contain Fixme attribute and unnamed highways. This style may be used alone or combined with other styles such as Potlatch2 and Mapnik (Tested in JOSM only). 0.8_2014-10-27
EPCI (France) Don-vip Display French local authorities (known as EPCI) 1.3_2011-07-09
Paddenstoel guidepost vsandre Show a special icon for a paddenstoel guidepost. More details 1.5_2011-05-20
Highway Nodes naoliv Highlights untagged and unconnected nodes in a way More details 1.3_2014-01-16
Boundary_Stone ajoessen,lutz Visualization of some historic=* tags 0.6_2012-07-06
HU-HighlightHikingTrailSigns efemm Highlight hiking trails icons, optimized for Hungarian marking. More details 1.1_2014-08-01_9
Japan Impassable Ways cmuelle8 Dash out ways tagged with barriers, visualize practicability=* More details 1.5_2011-03-22
icon Japan Tsunami POIS PierZen POIS related to Tsunami plus Surface / Roads with damages, obstacles More details 1.21_2014-10-23
Landcover tags Martin Vonwald Show landcover and some additional landuse tags 0.4.11_2014-03-31
icon Lane and road attributes Martin Vonwald Visualization of lanes, width, turn lanes, changing the lane, destination, lighting and street lamps, sidewalk, cycletracks, bicycle lanes, bus lanes, psv lanes. More details 2.7-52_2014-10-30
Lane details, right-hand traffic, arrow version Wolfgang Hinsch Shown tags:: lanes, turn lanes, bus lanes, changing the lane, cycleways, sidepaths and lightning 0.11_2014-06-29
Lane details, right-hand traffic, color version Wolfgang Hinsch Shown tags:: lanes, turn lanes, bus lanes, changing the lane, cycleways, sidepaths and lightning 0.5_2014-07-02
icon JOSM default (XML; old version) Old version of JOSM default style 1.8_2014-10-27
Less obtrusive nodes xeen Make nodes smaller when zoomed out. This makes navigating easier when viewing a large area. Also hides icons and text accordingly. More details 1.8_2014-08-26
Lit cmuelle8 Show lit=yes/no settings in JOSM map display 1.3_2012-09-01
icon Lit Objects achadwick Supplementary stylesheet which highlights lit and unlit objects by surrounding them with large glows. Works well with the Potlatch 2 base style. 0.1_2012-02-01
icon Maxspeed Rubke, Dirk Stöcker, Vclaw, Klumbumbus Display maxspeed values in JOSM map display. More details 2.0.13_2014-10-30
Speedlimit Signs Martin Koppenhoefer Display maxspeed on nodes by Speedlimit signs. 2.10_2014-09-22
Modified objects Sebastian Klein Highlight modified objects 0.1.6_2011-02-24
Mountains lzhl Indication mountain terrain tags 0.5_2013-12-07
MTB Heiko Woehrle visualize mtb:scale of objects More details 0.12_9_2014-10-06
new parking features Mario Schütze Display the new parking features from "Proposed_features/parking" (see link). More details 1.2_2012-02-05
Streets Have No Name Yann Coupin Could be a U2 song: highlights where the streets have no name 0.3_2012-10-19
Numbered Cycle Node Networks Polyglot Highlight Numbered nodes and the routes in between them More details 1.6_2012-11-04
Numbered Walking Node Networks Marc Gemis Highlight numbered nodes and the routes in between them More details 1.3_2012-11-08
OSMC Hiking Martin Ždila <martin.zdila@…> Colorize marked hiking trails using OSMC tagging schema. 0.2.3_2013-11-03
OSMC Hiking (optimized for SK/CZ/PL) Martin Ždila <martin.zdila@…> Colorize marked hiking trails using OSMC tagging schema. Optimized for SK/CZ/PL marking. 0.2.2_2013-11-03
Parking lanes Sebastian Klemm, Kay Drangmeister Parking lanes along roads and parking/stopping restrictions. More details 0.10_2014-11-12
Collapsed/damaged buildings Hjart Style to classify buildings More details 0.4_2013-11-17
plan.at ToDos simon04 Highlight problematic objects from plan.at import More details 1.4_2011-05-03
potlach2 access iav Visualizes access tag on highways. Made only for Potlach2 JOSM style 0.2_2012-11-30
Power Cobra A more detailed style for various power facilities and features 0.3.3_2014-04-01
Power Mapping Additions prabhasp Special icons for facilitating mapping of power lines; in development. More details 0.1_2013-04-22
Public Transportation Polyglot Highlight important information regarding Public Transportation More details 1.5_2012-11-04
icon sac_scale Klumbumbus Displays sac_scale=* coloured. More details 1.011_2014-10-30
icon ShowID Klumbumbus This style is for a layer with the .osm file from Keypad-Mapper 3. It shows the (positive) IDs of the housenumbers. So you can see the sequence of the nodes, how you recorded them. For more information how to use this style see the link. More details 1.0.012_2014-10-30
Sidewalks Cobra Visualizes the sidewalk attribute of highways. sidewalk=* is rendered as a thick dashed line, seperately mapped sidewalks tagged footway=sidewalk are rendered thicker. More details 0.4_2014-05-31
Simple building tags heilbron Visualize the presence of some basic simple 3D building tags (wall colour, number of building and roof levels) More details 1.12_2014-10-01
Simple roof tags heilbron Visualize the presence of some simple roof tags (shape & colour) More details 1.9_2014-03-21
Colorize bicycle routes Martin Ždila <martin.zdila@…> Colorize bicycle routes tagged with tag colour. 0.2.4_2013-11-03
Surface - Data Entry AndrewBuck This styling is intended for data entry of road surface tags from aerial imagery. The style not only shows the status and value of the surface tag, but also refrains from drawing directly on the road allowing a clear view of the road surface in the imagery to allow for easier editing/checking of the surface values. More details 1.0.8_2014-06-13
Surface cmuelle8 Visualize surface=* of objects More details 1.24_2014-10-23
traffic_signs_ yopaseopor Display all the signs you put the info in osm.Specially recomended with roadsigns pluggin 1.14_2013-07-31
Tree-Crown_Diameter AndrewBuck This style shows which trees have a tree crown diameter entered on them and if so, attempts to show the trees relative to their size. More details 1.0.3_2014-10-23
Whitewater pankdm Visualization of some whitewater=* tags 0.4_2011-09-10
Irish Boundaries IrlJidel MapCSS to highlight Irish townland, electoral district, civil parish and barony boundaries 0.8

Create your own style

You don't like the standard style? Change it to your own liking:

  • In the map paint style dialog, right click one of the styles and select source:/trunk/images/copy.png"save as...". A copy will be added to the list of styles. You can open the file in a text editor and reload after doing some changes.
  • Or create a style from scratch and add it in the JOSM mappaint preferences.

JOSM supports two formats to define a style:

JOSM XML
The previously traditional style format in JOSM (still functional). The old standard style contains some documentation.
MapCSS
Style language similar to CSS originally developed for Potlatch 2, but aims to be a standard for map styles.

Style files with different formats are compatible, they can be loaded at the same time.

Make your style available to other users

  • Either edit this wiki page and add URLs for new style files to the list at the top.
    • Note: Only URLs with file-extension (e.g. *.mapcss, *.xml, *.zip, *.php) are supported.
  • Or create a wiki page similar to Styles/LegacyStandard (XML) or Styles/Modified (MapCSS).
    • for automatic version adjustment you should use two internal variables:
      • [[revision]] - is the latest version number of the wiki page
      • [[date]] - is the date of the last edit
      • e.g. "1.[[revision]]_[[date]]" converts to e.g. 1.13_2014-02-24)
    • Note: Spam filter prohibits adding many external (icon) links. Please, if possible, attach icons to the wiki page (see below).

In both cases, the new style will be automatically listed in the table above after a few minutes. Then it will also be available in the JOSM mappaint preferences (after clicking the reload button).

Icons

.png and .svg files are supported.

Icon handling

There are different forms to handle icons:

  • Icons distributed with JOSM can be entered directly with the path (relative to JOSM's internal image directory).
  • Use a path relative to your local style file.
  • New icons can be directly referenced using a http-link. These are downloaded and cached internally.
  • Since JOSM revision 2289 zip files are supported.
    • The zip file must contain at least one file with extension xml (or mapcss).
    • Icon names and path are relative to the topmost zip directory.
    • If there are multiple XML files, a file with "style" in the name is preferred (to allow packaging styles and presets in one archive).
  • Since JOSM revision 4713 inline encoding as described in RFC 2397 is supported.
    • Example for PNG: data:image/png;base64,...databytes...
    • Example for SVG: data:image/svg+xml;base64,...databytes...
    • More information about data:image/... in JOSM.
  • When the JOSM wiki is used for designing of new styles you have some additional options:
    • Each file attached to the wiki page is automatically included in the zip file downloaded by JOSM.
    • If you don't want a file in the zip file, add the text (NOZIP) in the description of the attachment.
    • If you add a zip file and want its contents included, you may add (EXTRACT) in the description of the attachment.
    • The server automatically switches from download of single file to zip download when files are attached.

Styles managed in JOSM wiki

Rendering

Mappaint renders the map data so it looks much more like a map (colors, icons, annotations, ...) - compared to the JOSM wireframe mode.

Nodes

Most nodes that correspond to tags in the Map Features page will show an appropriate icon, e.g. a white "P" on blue ground for amenity=parking.

There are some special icons for missing/incomplete things:

no icon missing icon
We don't have the right icon for every node tag in map features yet, e.g. icons for most natural=* tags are still missing. If you encounter such a "missing icon", feel free to create a nice 16*16 pixel icon that matches the tag. To submit your work, open a new ticket and add your image or zip archive as attachment.

deprecated icon warning icon
The corresponding tag was once used but is no longer recommended to be used - or - it is not suitable for a node, e.g. highway=motorway just doesn't make sense on a node. Probably not all deprecated tags will show this icon.

Ways

Most ways that correspond to tags in the map features page will get special color, thickness and line style (e.g. dashed lines for railways).

Areas

Areas are ways that form a sort of ring. Most areas that corresponds to tags in the map features page will be filled with a special color (the filling will be transparent to some degree).

Advanced Preferences

Some styles may have options. They are available via a right click on the style's entry inside the map paint style dialog window. E.g. JOSM's current default map style (MapCSS) has the option to disable the "less obtrusive" nodes at low zoom levels.

In addition, you can use the following hidden preferences:

  • mappaint.fillalpha
    • alpha "opacity level", that is used to fill areas. An integer value between 0 (transparent) and 255 (solid) with the default of 50.
  • mappaint.fillareas (show areas)
    • 10000000 (default) - areas will be filled with their corresponding colour and name will be rendered
    • 0 - areas will be surrounded by lines only and name will not be rendered
    • any other number - areas will be filled with their corresponding colour and name will be rendered at any zoom level below the given number in meters
  • mappaint.showicons
    • select whether icons are shown - same values as mappaint.fillareas
  • mappaint.shownames
    • select whether names are shown - same values as mappaint.fillareas
  • mappaint.strokes
    • select whether strokes or full lines are used - same values as mappaint.fillareas
  • mappaint.useRealWidth
    • true - ways will change width corresponding to the real width in meters set in the elemstyle.xml file
    • false (default) - ways will have the same width on every zoom level
  • mappaint.zoomLevelDisplay
    • true - elements visibility depends on zoom level
    • false (default) - all elements are displayed
  • mappaint.fontsize
    • size of mappaint texts (default=8)

Back to main help

Last modified 6 days ago Last modified on Dec 15, 2014, 1:19:51 AM

Attachments (3)

Download all attachments as: .zip