Plotting focused library for OpenStreetMap data
Author juliusgeo
7 Stars
Updated Last
1 Year Ago
Started In
September 2018



This package was created to be an improvement on OpenStreetMap.jl's plotting capabilities. As opposed to OpenStreetMap2.jl or OpenStreetMapX.jl it is focused primarily on creating beautiful plots using Winston.jl from OpenStreetMap data, and additionally exporting those plots to other formats such as GeoJSON.


It can parse OpenStreetMap maps from either a bounding box (which then fetches the map from the Overpass API) or from a .osm file. It uses three functions to create arrays of either the nodes, the ways, or the relations in the map. These are defined by structs in the library, and have all the attributes that OSM objects do, just in an easier format to work with in Julia. In addition, it has a plotting function which uses Winston.jl to create beautiful renderings of the maps.

The main ways in which this package improves on OpenStreetMap.jl:

  • The graphing function is able to draw buildings and other OSM objects like parks, rivers, etc, as polygons rather than just as outlines.
  • Because this package is primarily focused on extracting data from the OSM objects, rather than on geometry, the structs are much easier to understand because everything is in WGS84 projection.
  • In OpenStreetMap.jl, smaller streets that adjoin a larger street will sometimes be drawn over the larger street. This package delays the drawing of motorways, trunks, and primary through tertiary ways so that they display correctly when plotted.

The styling for all the different object types is defined in styles.jl, which is composed of a few dictionaries that map OSM tags to Style objects. These dicts are accessible to the user, so you can easily change the styling as you wish.

Planned Features

  • Ability to export to QGIS
  • Better theming options

MapCSS Support

Currently, OpenStreetMapPlotter.jl supports a subset of MapCSS features. The only attributes which can be set are width and color, but ways can be filtered by what tags they have and also by the values of those tags. Example:

{width: 2; color:black;}
{ width:2; color:green;}

Supported operators are: !=, =, <=, >=, >, <. Note: the statements in the CSS file are executed sequentially, so later statements will override earlier statements


#open a file from bounding box...
julia> bbox = (-75.2262,39.9365,-75.1327, 39.9821)
julia> xml = open_bbox(bbox)
#or from a file
julia> xml = open_file("map2.osm")

#parse the ways
julia> way_arr, bbox = parse_ways(xml)

#plot it
julia> plot_ways(way_arr, bbox)
#or plot it using a CSS file to define the appearance
julia> plot_ways(way_arr, bbox, css_file_name="src/test.css")

Example map of West Philadelphia

Used By Packages

No packages found.