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.

Reviewing your edits

Mapping guides

Reviewing your edits

JOSM Validator

The easiest way to fix common mapping issues is to use the inbuilt validator in JOSM. All edits made in a session are automatically validated and a warning will be displayed before upload if any suspicious data is found.

screenshot 2015-12-11 14 30 37


  • Select the data you want validated and press Shift+V or hit Validate from the Validator panel. If no data is selected, the Validator will run on all the data in the active layer.
  • A Validation errors layer will be added to your Layers to highlight features with errors.
  • The Validation Results panel will display all the detected errors. Select any of the detected errors to fix. You can right click an entry and zoom to the location if needed.

using validator

The Validation Results have several buttons activated to navigate and fix errors:

  • Select – Select the objects of the selected error.
  • Lookup – Looks up the selected primitives in the error list.
  • Validation – Start validation process for current selection or all objects (when nothing selected).
  • Fix – Fix an error (only when automatically fixable).
  • Ignore – Ignore an error or a group of errors in future tests.

Customizing error detection

By default the validator checks against a wide range of data issues, many of which may not be important or may contain false positives. You can customize the settings from Preferences > Data Validator

validator settings

For more details check the OSM Wiki and the LearnOSM Guide

Overpass Turbo

You can quickly query and visualize OSM data live using Overpass Turbo.

screenshot 2015-12-11 16 14 31


  • Browse the map to the area of interest or alternatively set a bounding box using the map tool on the left.
  • Write an Overpass Query in the query editor or use the Wizard for simple tag queries like highway=motorway or highway=trunk
  • Optionally add a MapCSS style to visualize the results
  • Hit Run to execute the query on the OSM data and display the results. Tip: By default small ways are rendered as circles. To fix this check the Don't display small features as POIs option from Settings > Map

For more details check the OSM Wiki, Learn Overpass or some common example queries.