OSMnx documentation

OSMnx: retrieve, construct, analyze, and visualize street networks from OpenStreetMap. OSMnx is a Python package that lets you download spatial geometries and construct, project, visualize, and analyze street networks from OpenStreetMap’s APIs. Users can download and construct walkable, drivable, or bikable urban networks with a single line of Python code, and then easily analyze and visualize them.

Citation info

Boeing, G. 2017. “OSMnx: New Methods for Acquiring, Constructing, Analyzing, and Visualizing Complex Street Networks.” Computers, Environment and Urban Systems, forthcoming. doi:10.2139/ssrn.2865501.


Install OSMnx with pip by running:

pip install osmnx

or with conda by running:

conda install -c conda-forge osmnx

If you have any trouble with the installation, try installing OSMnx in a new, clean virtual environment:

conda create --yes -c conda-forge -n OSMNX python=3 osmnx
source activate OSMNX


For examples and demos, see the GitHub repo: https://github.com/gboeing/osmnx


The project is licensed under the MIT license.

Indices and tables