OSMnx documentation¶
Contents:
- osmnx package
- Submodules
- osmnx.core module
- osmnx.downloader module
- osmnx.elevation module
- osmnx.errors module
- osmnx.footprints module
- osmnx.geo_utils module
- osmnx.osm_content_handler module
- osmnx.plot module
- osmnx.pois module
- osmnx.projection module
- osmnx.save_load module
- osmnx.settings module
- osmnx.simplify module
- osmnx.stats module
- osmnx.utils module
- Module contents
OSMnx: retrieve, model, analyze, and visualize street networks from OpenStreetMap. OSMnx is a Python package that lets you download spatial geometries and model, project, visualize, and analyze street networks from OpenStreetMap’s APIs. Users can download and model walkable, drivable, or bikable urban networks with a single line of Python code, and then easily analyze and visualize them. You can just as easily download and work with amenities/points of interest, building footprints, elevation data, street bearings/orientations, and network routing.
Citation info¶
If you use OSMnx in your work, please cite the journal article:
Boeing, G. 2017. “OSMnx: New Methods for Acquiring, Constructing, Analyzing, and Visualizing Complex Street Networks.” Computers, Environment and Urban Systems 65, 126-139. doi:10.1016/j.compenvurbsys.2017.05.004
Features¶
OSMnx is built on top of geopandas, networkx, and matplotlib and works with OpenStreetMap’s APIs to:
Download street networks anywhere in the world with a single line of code
Download other infrastructure network types, place polygons, building footprints, and points of interest
Download by city name, polygon, bounding box, or point/address + network distance
Download drivable, walkable, bikeable, or all street networks
Load street network from a local .osm file
Visualize street network as a static image or interactive leaflet web map
Simplify and correct the network’s topology to clean and consolidate intersections
Save networks to disk as shapefiles, geopackages, GraphML, or .osm
Conduct topological and spatial analyses to automatically calculate dozens of indicators
Calculate and plot shortest-path routes as a static image or leaflet web map
Fast map-matching of points, routes, or trajectories to nearest graph edges or nodes
Plot figure-ground diagrams of street networks and/or building footprints
Download node elevations and calculate edge grades
Visualize travel distance and travel time with isoline and isochrone maps
Calculate and visualize street bearings and orientations
Examples and demonstrations of these features are in the GitHub repo (see below). More feature development details are in the change log.
Installation¶
You can install OSMnx with conda:
conda config --prepend channels conda-forge
conda create -n ox --strict-channel-priority osmnx
Alternatively, you can run OSMnx + Jupyter directly from its official docker container, or you can install OSMnx via pip if you already have all of its dependencies installed on your system.
Support¶
If you’ve discovered a bug in OSMnx, please open an issue at the OSMnx GitHub repo documenting what is broken in the package. Alternatively, if you have a usage question, please ask it on StackOverflow.
License¶
The project is licensed under the MIT license.