OpenStreetMap file
OpenStreetMap file
Filename extension .osm and .osm.xml
Type of content Map
Open format? Yes
SUMO specific? No
XML Schema XSD of API v0.6


The screenshot of an OpenStreetMap file opened in JOSM. It shows the map of the German city Eichstätt.

An OpenStreetMap file contains an extract of the OpenStreetMap database. The data is saved in an XML structure. The file name typically ends with .osm or .osm.xml.

You can get an OpenStreetMap file in various ways. The page Networks/Import/OpenStreetMapDownload explains them.

In the context of SUMO, an OpenStreetMap file can provide the map for the traffic simulation. It serves as the basis for a SUMO network file. The pages Networks/Import/OpenStreetMap and Tutorials/Import from OpenStreetMap show how to convert an OpenStreetMap file to a SUMO network file.

An OpenStreetMap file contains a map with the following features related to traffic simulation:

  • The nodes and their connections define the position and form of all streets and junctions.
  • The type of a street specifies its size and importance (key highway).
  • The speed limit of a street is usually determined implicitly by law. The implicit value may depend on the value of the highway attribute. In case, the speed limit differs from the implicit legal value, it is given explicitly through the key max_speed of a street.
  • The total number of lanes (for both directions) has an implicit value depending on the highway property. If the real value differs from the default value, it can be given through the key lanes.
  • The position of every traffic light is described as a node with the key-value pair highway=traffic_signals.
  • One-way streets are marked with the key-value pair oneway=yes.

Compared with the SUMO network file format, the OpenStreetMap file format lacks in

  • The logic of the traffic lights and
  • The meaning of lanes and the connections between lanes at a junction.

Software for Viewing, Editing and Processing#

The OpenStreetMap wiki lists a few tools to process OpenStreetMap files. As a graphical editor, JOSM is very popular. You can modify roads and tags with it and also run some validation checks. The command line editor Osmosis allows automated processing of OpenStreetMap data (see, for example, Networks/Import/OpenStreetMap#Editing OSM networks).

To use the map in the OpenStreetMap file with SUMO, you must convert it in a SUMO network file. Typically you do this with netconvert (see also Tutorials/Import from OpenStreetMap and Networks/Import/OpenStreetMap). You could also use eWorld to manipulate a OpenStreetMap file and convert it in a SUMO network file.