Java Applet

From OpenStreetMap Wiki
Jump to navigation Jump to search
Java Applet
License: GNU General Public License
Platforms: Windows, Linux, and macOS
Version: (2007-12-24)
Language: English
Programming language: Java

discontinued, replaced by Potlatch

London data shown within the applet, with Yahoo! aerial imagery in the background, back in 2007

The Java Applet was a Java-based in-browser editor. It was the original editing interface appearing on the 'edit' tab on the OSM homepage. This was replaced by the Flash-based in-browser editor Potlatch back on 5th May 2007. See also History of OpenStreetMap.

Status: Since then the java applet has not been maintained, and is not running anywhere. It does not work with the latest API version. It is compatible with API v0.4.

If anyone does want to see and use the applet you will need to host your own copy or run it as a local java application. But since it doesn't work with the latest API, it will no longer function as an editor.

Old Applet Help information. (Historical interest only)

Running the java applet

In order to edit maps, you must be registered and logged in.

Originally you were then able to go to click the "edit" tab to take you to the Java applet for editing. Currently to run the java applet you will need to run your host your own copy or run it as a local java application.

The Java Applet editing interface uses Java, so be sure to enable it in your browser. It requires Java version 1.5 or above. Get the latest Java browser plugins from Sun's download page (or your favourite JVM provider)

The Java applet requires some extra permissions, which you will need to grant.


This screencast gives a brief, high level introduction to editing with the applet.

The applet interface

When the applet loads, you will see a view of the map with a satellite photo beneath it.

In the top left corner is a toolbar, with features described below.

Green lines represent lines that have already been drawn in but do not yet form part of a way, and black dots are nodes. White lines represent line segments that have been made into part of a way. A red node shows the currently active node (e.g. when drawing lines).

Everything you do is saved as you edit, so there is no separate "upload data" stage.

The toolbar

The following tools are available in a small toolbar in the top-left. Descriptions will also appear in your browser status bar as you mouse over the toolbars.

hand Pan Select this tool and move the map around.
There will be a long delay after panning, as the map redraws the new area from scratch
. Add node Select this tool and click on the map. A node will be created, and uploaded to OSM.
When the "uploading..." caption disappears, the node creation is done and you can continue.
Nodes can be connected together with segments and ways to create a road, or they can be used as point features, e.g. pubs or fuel stations.
\ Add segment Select this tool, and drag a line from one node to another (each node should turn red as your mouse approaches it), and a segment will be created.
When the "uploading..." caption disappears and the segment becomes opaque light green, the segment creation is done and you can continue.
These segments are only the first part of the road-creation process, and should be added to Ways to create a road.
> Create Way To create a way click the "create way" button, and then click on each line segment which forms part of the way. As you click on a segment it turns a brown colour, and the "new way properties" dialog box appears
A Edit Select this tool and click on a node or way, it will popup a box allowing you to change attributes (e.g. road type) - see below.
+ Move Select this tool. As you move the mouse over a node, it will change colour. Hold the mouse down on the node and drag it to a new position.
Any attached segments will move automatically, although they may also remain shown at their old position until the map is redrawn.
Wait for the "uploading..." caption to disappear before continuing
X Delete Select this tool. As you move the mouse over a node or segment, it will change colour. Click on a node or segment to delete it from OSM.
Wait for the "uploading..." caption to disappear before continuing
zoom Zoom out Select this tool and click to zoom out to edit a larger area.
There will be a long delay while the map is redrawn
zoom Zoom in Select this tool and click to zoom in to edit a smaller area.
There will be a long delay while the map is redrawn

Keyboard shortcuts

[ ] Zoom in, Zoom out
{ } Increase/decrease Yahoo! Aerial Imagery detail
− + Increase/decrease the size of map features


The purpose of the editing applet is to allow you to enter nodes, which define points on a road or path etc., and then for you to join these nodes together to form line segments, which define the path of the road or path, to produce the basic map. Line segments can then be combined with adjacent segments to form part of a longer "way". The following explains how to do these simple tasks.

Go to the viewer and zoom in on an area that you want to work on. It helps to pick an area that you know reasonably well. The place where you live is probably the best place to start, then work outwards from there. If what you see doesn't make any sense then pan around a bit until you see something distinctive that you recognise.

For an instructional video, created by Imi, which shows the more advanced features of the applet see: (playable with VideoLAN).

Adding nodes

To plot new nodes you select the "Add node" toolbar button (Big node.PNG) and then click on the map. Add nodes for individual features such as a pub or a post office. You also need nodes before you can create segments of a road that you want to map (next section).

Click where you want to add the node. You may need to click twice if the applet didn't have the focus. A navy blue dot, called a Node, should appear on the spot you clicked. You can also add nodes to existing segments by clicking near enough to them.

If you can't clearly see the black nodes (dots), you need to increase their size by pressing + repeatedly on your keyboard. As you do this, the black nodes and the green and white lines will both increase in size.

Some new nodes, ready to be joined with lines
Creating line segments

Keep adding nodes (black dots) along the route that your line will follow. Once you have drawn enough nodes to describe a section of line clearly, use the add segment toolbar button (BigSegment.PNG) to create segments joining the dots. This is fun: the node beneath your mouse pointer will turn red, drag from this node to the next one. The second node will now turn red, you can then release the mouse button and a green line will remain.

Mark further nodes along the road that you want to map. If the road is quite straight then the dots can be quite far apart (as a rough guide, 3 to 6 nodes per screenful is about right). If the road curves then the nodes will need to be closer together to get a nice smooth shape.

You may want to tidy up the line of the road by selecting the Move toolbar button (Big move.PNG) and dragging any of the nodes that are not nicely aligned.

If you're drawing a road that is a one-way street, it's helpful to draw the line in the direction of travel. If it's not a one-way street, you should draw it in a left-to-right, top-to-bottom direction where possible. Street names are rendered in the direction of the segments, so drawing segments right-to-left will result in upside down streetnames.

The next step is to create a 'way'.

Drawing the first line, from the left node to the middle one
Joining this line to the corner...
...and carrying on with the next line
Creating a way

To create a way click the "create way" toolbar button (Big way.PNG), and then click on each line segment which forms part of the way. As you click on a segment it turns a brown colour, and the "new way properties" dialog box appears. Once you have selected every line segment which forms part of the way you may then enter the properties for that way. (The properties dialogue box may have moved under your main browser window as you selected more segments: minimise or move the main window to reveal the dialogue box again.)

Note, even if your street consists of just one segment, you should create a way consisting of just that one segment. Then information about that street should be added to the "way" not to the "segment".

Three line segments selected to form a new way
Way properties

In the "basic tab" you can enter the street name, and tag it as the most common types of roads.

If your chosen road type is not shown here you will need to use the Advanced tab. If you're not sure which tag to use, or need to see what other tags you could use, then see the map features page

If you are happy with the details you have entered then click the "OK" button.

If you wish to add more details for the way the click the "advanced tab" where you can add key / value pairs to define the way. For details of key / value pairs see the map features page. In the second image to the right, the advanced tab is selected, and a key / value pair of "Key - highway, Value - footway" has been entered to mark the way as a footway / footpath. Once you have entered all the details for the way then click the "OK" button. Note: tags are case-sensitive, most are all lower-case.

Adding or removing segments from an existing way can be done by bringing up "Way Properties" for the way by clicking "A" (property mode) and select one of the segments of the way. Now select the "Segments" tab and tick the "Change" checkbox. The segments currently associated with the way is colored red on the map and segments can now be added/removed by clicking them on the map. Be sure to find your way back to the "Way Properties" dialog and press "OK" after changing the segments or else you changes will be lost!

Way Properties, basic tab
Way Properties, advanced tab

Please do not copy street names from an existing copyright-protected street map. These printed maps contain "gotcha's" to catch copiers and establish a basis for infringement of copyright. If you know the name of the street or road that’s fine, otherwise please verify it first.

Naming a street

Integration with other editors

Many OSM contributors use the applet in conjunction with other editing tools. Examples:

  • Create nodes in the applet, then download those nodes in JOSM to combine them into segments and ways
  • Create a map with approximate positions in JOSM, then use the applet to drag nodes around until they align with visible features

Using a different editor for some tasks means that you can edit your data while the applet is busy loading the next area.

Next steps

Once you have mapped a few roads you may want to try your hand at road junctions and roundabouts. The Editing Standards and Conventions page gives some illustrated examples as a guideline. These are fun and interesting to draw. Once you feel confident, you may even want to try your hand at a freeway intersection or two.


  • Sometimes the applet will not download tiles from the Yahoo site. In this case, you will see a gray area, to fix this re-click the "edit" tab to reload the current area.
  • Sometimes the nodes are too small to see. Use the + key repeatedly to increase their size. Use - to make them smaller.
  • Sometimes the applet will not display a background satellite map. It is unclear what to do in this case.


There are a number of bugs in the Java applet. We keep track of these using "trac" (bug-tracking system). Query to find all applet bugs. You can raise new bug "tickets" directly if you create a trac account, alternatively discuss the issue via one of the Contact channels.

The applet will spew debugging information including Java stack traces to the JVM console. This may be useful in diagnosing problems, particularly when the applet seems to crash. On Microsoft Windows, Look for a little Java icon (blue coffee cup) in your system tray in the bottom right. Right click and choose "Open console". This may vary depending on JVM installation options and certainly operating system.

Interested in fixing bugs? See Java Applet Development

See also