Mapbox OpenStreetMap

OpenStreetMap is the free and editable map of the world, created and maintained by a huge international community. Mapbox Streets, our customizable map layer of streets, buildings, and places from all around the world, is powered by open data from OpenStreetMap. Anybody can create an account and start editing on within minutes.

Our data team updates OpenStreetMap based on quality analysis and customer feedback. Our principle is to work in the open, these mapping guides are primarily consolidated and maintained by our data team for various mapping projects and on-boarding new team members.

You are welcome to join one of our open mapping projects over on the issue queue and use these best practice mapping guides. These guides are licensed under Public Domain (CC0), if you would like to contribute or have an feedback on these, please feel free to raise an issue in this repository.

Mapping with OpenStreetMap

Mapping guides

Getting started

To get started editing OpenStreetMap using JOSM, set up your work environment with the tools you would need.

1 guide


Selecting the appropriate source and translating it correctly into OpenStreetMap is immensely important - it's the definition of great mapping.

1 guide

The OpenStreetMap data model

In OpenStreetMap, each feature is described as one or more geometries with attached attribute data.

1 guide

Mapping with JOSM

Get started mapping with the Java OpenStreetMap editor (JOSM) - a powerful and popular desktop editor for OpenStreetMap.

1 guide

Mapping common features

A walkthrough of how to create and edit the most common features on OpenStreetMap.

1 guide

Mapping for navigation

Learn the guidelines to map different components to help build a great navigational engine.

11 guides

Becoming a power mapper

These advanced topics will allow you to take your mapping skills to the next level.

9 guides

Validating OpenStreetMap

A walkthrough of how to detect, inspect and fix potentially harmful changes in OpenStreetMap.

1 guide