Project Guideline

This project is currently on: PHASE 1

Project Phases

Work on this project is done one phase at a time. Also, with the exception of Phase 1, work is done one municipality at a time.

Phase 1: Fix and add state roads (carreteras estatales). Normal geometry fixes on existing state roads are planned here.

Phase 2: Correct the widespread wrong assignment of “highway=track” tags . Geometry fixes on existing roads are planned here on really bad cases.

Phase 3: Add new non-state roads (recently developed urbanizaciones, etc).

Phase 4: Fix existing non-state roads. This includes improving positional geometry when necessary and also simply removing roads that don’t exist.

As seen on the phases above, this project is really a partial review for roads. A full review, which is beyond this project’s scope, would be to actually review a road’s geometry and tags (name, etc) with local or ground knowledge, and finally deleting the “tiger:reviewed=no”tag. Important: the “tiger:reviewed=no” tag was assigned to all TIGER roads from the beginning by OpenStreetMap. The idea is to have mappers remove this tag once they fully review a road with local or ground knowledge. So leave it for roads you just partially reviewed!

Setting Up Your Work Environment

  1. After PHASE 1 is finished: Pick a Municipio you’d like to contribute to. First, take a look at the PR TIGER Fixup Progress Map to know which municipios are “Up for grabs”. Now, still in the map, press the “UPDATE MAP” button to reserve a municipio by filling out a simple form; no login is required. This is the same form you’ll come back later to keep updating the percentages shown on the map.

  1. Use a grid to guide you along your municipio.  Download here. This is a GPX format layer that you can bring up as a reference in iD or JOSM. Use it to go row by row, west to east (or viceversa) covering all places. See Appendix A at the end of this document to to learn about adding it to iD or JOSM.

  1. Prepare your editing environment. Open up iD or JOSM, and zoom to your municipio. Add your GPX layer grid as an overlay. Add imagery and other layers as references as detailed in the next section...


Get a good idea of how to tag highways here: Key:highway - OpenStreetMap Wiki


Road data:

Some Tips




Road is misaligned (outside road area as shown on imagery).

With imagery on the background, align it by dragging it or adding/deleting nodes as you think necessary. I always try to not delete whole roads or segments and rather work with what’s there. That way you preserve tags and connectivity.

Entire road or a segment in reality doesn’t exist.

Remove it!




There’s a new road to map!

Zoom into the imagery as adequate, make sure to connect the new road to an existing one (just click anywhere on top of it), and draw your new road. Now add some basic tags to it (basic tags if applicable: highway, name, ref, oneway). For example: “highway=residential” and “name=Calle Constitución”.  If you don’t know the new road’s name based on local knowledge, look up what US Census TIGER roads say: TIGERweb  (use only public domain sources please, not Google Maps). In PR it’s common to see lower class roads without names. Alternately, there are roads with two names. For this, other than the “name” tag, add this other tag: “ref=ThatOtherName”. Side note: you’ll see existing roads in OSM with “tiger=this” or “tiger:something=that” tags, you don’t have to add these.

An existing road in OSM has an old name, which is not the name people use today. Commonly found in gated communities.  First the road was known as “Calle 1” and now is “Calle Picaflor”.

What I would do at least is have this tags: “name=Calle Picaflor” and “alt_name=Calle 1”. What you people think?


Appendix A. Overlaying a GPX layer in your editing environment.