IT Jam 2009 presentation, covering usage of Python with and in OpenStreetMap.

1. OpenStreetMap and Python
Andrii V. Mishkovskyi
October 27, 2009
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 1 / 23

2. What is OpenStreetMap?
In short:
The Wikipedia of
Maps
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 2 / 23

3. What is OpenStreetMap?
Free
CC-by-SA
Constantly evolving
Easy to start
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 3 / 23

4. Languages used
Ruby site
C++ rendering, editors, utilities
Python rendering, utilities
Java utilities, editors
PHP wiki
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 4 / 23

5. Python tools
bulk upload.py
PythonOsmApi
CloudMade’s Python API
Mapnik
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 5 / 23

6. Outline
Mapnik
Other tools
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 6 / 23

7. Overview
Render tool
Written in C++
Boost.Python for bindings
Lots of input plugins
PNG, JPG, SVG, PDF output
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 7 / 23

8. Example, part 1
import mapnik
map = mapnik.Map()
map.background = mapnik.Color(’steelblue’)
rule = mapnik.Rule()
rule.symbols.append(
mapnik.PolygonSymbolizer(
mapnik.Color(’#f2eff9’)))
rule.symbols.append(
mapnik.LineSymbolizer(
mapnik.Color(’rgb(50%,50%,50%)’), 0.1))
style = mapnik.Style()
style.rules.append(rule)
map.append_style(’Base’, style)

9. Example, part 1
import mapnik
map = mapnik.Map()
map.background = mapnik.Color(’steelblue’)
rule = mapnik.Rule()
rule.symbols.append(
mapnik.PolygonSymbolizer(
mapnik.Color(’#f2eff9’)))
rule.symbols.append(
mapnik.LineSymbolizer(
mapnik.Color(’rgb(50%,50%,50%)’), 0.1))
style = mapnik.Style()
style.rules.append(rule)
map.append_style(’Base’, style)

10. Example, part 1
import mapnik
map = mapnik.Map()
map.background = mapnik.Color(’steelblue’)
rule = mapnik.Rule()
rule.symbols.append(
mapnik.PolygonSymbolizer(
mapnik.Color(’#f2eff9’)))
rule.symbols.append(
mapnik.LineSymbolizer(
mapnik.Color(’rgb(50%,50%,50%)’), 0.1))
style = mapnik.Style()
style.rules.append(rule)
map.append_style(’Base’, style)

11. Example, part 1
import mapnik
map = mapnik.Map()
map.background = mapnik.Color(’steelblue’)
rule = mapnik.Rule()
rule.symbols.append(
mapnik.PolygonSymbolizer(
mapnik.Color(’#f2eff9’)))
rule.symbols.append(
mapnik.LineSymbolizer(
mapnik.Color(’rgb(50%,50%,50%)’), 0.1))
style = mapnik.Style()
style.rules.append(rule)
map.append_style(’Base’, style)

12. Example, part 2
layer = mapnik.Layer(’world’,
"+proj=latlong +datum=WGS84")
layer.datasource = mapnik.Shapefile(
file=’boundaries.shp’)
layer.styles.append(’Base’)
map.layers.append(layer)
map.zoom_to_box(layer.envelope())
mapnik.render_to_file(map, ’world.png’, ’png’)

13. Example, part 2
layer = mapnik.Layer(’world’,
"+proj=latlong +datum=WGS84")
layer.datasource = mapnik.Shapefile(
file=’boundaries.shp’)
layer.styles.append(’Base’)
map.layers.append(layer)
map.zoom_to_box(layer.envelope())
mapnik.render_to_file(map, ’world.png’, ’png’)

14. Example, part 2
layer = mapnik.Layer(’world’,
"+proj=latlong +datum=WGS84")
layer.datasource = mapnik.Shapefile(
file=’boundaries.shp’)
layer.styles.append(’Base’)
map.layers.append(layer)
map.zoom_to_box(layer.envelope())
mapnik.render_to_file(map, ’world.png’, ’png’)

15. Example, part 2
layer = mapnik.Layer(’world’,
"+proj=latlong +datum=WGS84")
layer.datasource = mapnik.Shapefile(
file=’boundaries.shp’)
layer.styles.append(’Base’)
map.layers.append(layer)
map.zoom_to_box(layer.envelope())
mapnik.render_to_file(map, ’world.png’, ’png’)

16. Wait for it...

18. Ta-da!

19. IRL example, part 1
import mapnik
projection = mapnik.Projection(
"+proj=merc +a=6378137 +b=6378137 "
"+lon_0=0.0 +x_0=0.0 +y_0=0 +k=1.0 "
"+no_defs +over +lat_ts=0.0 +units=m")
map = mapnik.Map(900, 600)
mapnik.load_map(map, ’/path/to/style.xml’)

20. IRL example, part 1
import mapnik
projection = mapnik.Projection(
"+proj=merc +a=6378137 +b=6378137 "
"+lon_0=0.0 +x_0=0.0 +y_0=0 +k=1.0 "
"+no_defs +over +lat_ts=0.0 +units=m")
map = mapnik.Map(900, 600)
mapnik.load_map(map, ’/path/to/style.xml’)

21. IRL example, part 1
import mapnik
projection = mapnik.Projection(
"+proj=merc +a=6378137 +b=6378137 "
"+lon_0=0.0 +x_0=0.0 +y_0=0 +k=1.0 "
"+no_defs +over +lat_ts=0.0 +units=m")
map = mapnik.Map(900, 600)
mapnik.load_map(map, ’/path/to/style.xml’)

22. IRL example, part 1
import mapnik
projection = mapnik.Projection(
"+proj=merc +a=6378137 +b=6378137 "
"+lon_0=0.0 +x_0=0.0 +y_0=0 +k=1.0 "
"+no_defs +over +lat_ts=0.0 +units=m")
map = mapnik.Map(900, 600)
mapnik.load_map(map, ’/path/to/style.xml’)

23. IRL example, part 2
coords = [(30.44, 50.455), (30.465, 50.459)]
coords = [mapnik.Coord(*coord)
for coord in coords]
coords = [projection.forward(coord)
for coord in coords]
bbox = mapnik.Envelope(*coords)
map.zoom_to_box(bbox)
mapnik.render_to_file(
map, ’whereweare.png’, ’png’)

24. IRL example, part 2
coords = [(30.44, 50.455), (30.465, 50.459)]
coords = [mapnik.Coord(*coord)
for coord in coords]
coords = [projection.forward(coord)
for coord in coords]
bbox = mapnik.Envelope(*coords)
map.zoom_to_box(bbox)
mapnik.render_to_file(
map, ’whereweare.png’, ’png’)

25. IRL example, part 2
coords = [(30.44, 50.455), (30.465, 50.459)]
coords = [mapnik.Coord(*coord)
for coord in coords]
coords = [projection.forward(coord)
for coord in coords]
bbox = mapnik.Envelope(*coords)
map.zoom_to_box(bbox)
mapnik.render_to_file(
map, ’whereweare.png’, ’png’)

28. Styles are cool!

29. Outline
Mapnik
Other tools
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 18 / 23

30. bulk upload.py
Mass imports of data
Perfect overview of working with OSM
API
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 19 / 23

31. PythonOsmApi
Thin wrapper over HTTP OSM API
Allows editing OSM data
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 20 / 23

32. CloudMade API
Shameless plug
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 21 / 23

33. CloudMade API
Access to CloudMade’s services
Routing, geocoding, tiles . . .
More coming soon
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 21 / 23

34. So. . .
OpenStreetMap is the biggest data
dump ever
Mapnik rules
APIs rule
Lots of work yet to be done
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 22 / 23

35. Links
osm.org
mapnik.org
cloudmade.com
wiki.osm.org
Andrii V. Mishkovskyi () OpenStreetMap and Python October 27, 2009 23 / 23