Java Applet Help
From OpenStreetMap
| | Software described on this page or in this section is unlikely to be compatible with API version 0.5 deployed on 8 October, 2007. If you have fixed the software, or concluded that this notice does not apply, remove it. |
| | This page has been labelled for deletion.
This normally means the page title is a bad one, and the content has been moved somewhere better. If a page title is vaguely meaningful, it should perhaps be a redirect instead. If you disagree with its deletion, please explain why on its talk page. The page history shows what used to be on this page, and allows people to rescue an old revision. We may decide to do this, but otherwise a wiki 'sysop' user can delete this page more permanently at some point. In the meantime we should fix any pages linking to here. |
| Read this page in English, Deutsch +/- |
| Help | About | Browsing | Editing | Upload |
The Java Applet is a browser-based editor that shows nodes, segments, and ways, and a satellite image of the selected area. As you zoom and pan it dynamically loads new data from the server. Any changes made using this editor are written to the OpenStreetMap database immediately.
Contents |
Java Applet is currently unavailable
Applet is currently unavailable. The 'edit' tab is now showing Potlatch.
The applet has been made Protocol version 0.4 compliant with a patch by TomH
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.
There are no instructions for doing this (FIXME)
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.
Screencast
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.
Keyboard shortcuts
| [ ] | Zoom in, Zoom out |
| { } | Increase/decrease Yahoo! Aerial Imagery detail |
| − + | Increase/decrease the size of map features |
Editing
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: http://www.eigenheimstrasse.de/josm/tutorials/applet-tutorial-ways.ogg (playable with VideoLAN).
| Adding nodes
To plot new nodes you select the "Add node" toolbar button ( 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. | |
| 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 ( 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 ( 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'. | |
| Creating a way
To create a way click the "create way" toolbar button ( 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". | |
| 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 and the Tagging FAQ If you are happy with the details you have entered then click the "OK" button.
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! | |
| Names
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. |
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.
Troubleshooting
- 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.
Bugs
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


