OpenStreetMap Americana

From OpenStreetMap Wiki
Jump to navigation Jump to search
For the city in Brazil, see Americana.
Open bug tracker
OpenStreetMap Americana logo.png
OpenStreetMap Americana
Americana collage.png
Author: Brian Sperlongano et al.
Based on: OpenMapTiles
Slippy map:
Style license: CC0 Public Domain Dedication
Source code: Font Awesome 5 brands github.svg ZeLonewolf/openstreetmap-americana

A quintessentially American map style

OpenStreetMap Americana is a public domain renderer being developed by members of the United States mapping community. The project began in May 2021 with a goal to eventually become part of the OpenStreetMap U.S. website, similar to regional renderers maintained by other OSMF local chapters in Europe and Asia. As of April 2022, it is currently in the early stages of development, with an initial focus on driving technical requirements in the underlying renderer and on the server side and cleanup efforts in the OpenStreetMap database.


Americana applies cartographic practices that are characteristic of maps published in the United States. American publishers have developed a system of conventional symbols and line treatments that is distinct from – and often incompatible with – those used by their continental European counterparts.[1] However, most preexisting OpenStreetMap-based renderers have been designed according to European conventions, making OSM itself feel unfamiliar and counterintuitive to some mappers. Americana departs from other OSM renderers in favor of American conventions, demonstrating the versatility of the OSM data that underlies all these renderers.

As a starting point, Americana currently resembles a road atlas, as roads were some of the first features to be implemented. The style does not slavishly copy a particular map or map publisher; instead, it hews to a "typical" road atlas aesthetic. Whenever a new feature is introduced, contributors survey a number of print maps for inspiration. Although the project began with a focus on road features, it is not limited to motorized transportation. As the project begins to focus on higher zoom levels and a broader set of features, other design sources may become relevant, such as city tourist maps and topo maps. See this brainstorming document for more ideas that have been proposed for the project roadmap (no pun intended).


Features inspired by political maps:

  • Places and points of interest use familiar symbology, such as a star on each state capital.
  • Boundary lines are emphasized by a colored glow.
  • Disputed boundaries are distinct from mutually acknowledged boundaries.

Features inspired by road atlases and road maps:

  • Highways in the U.S., Canada, and several countries in Europe and Asia,[2] are marked by route shields instead of a one-size-fits-all symbol ("pancake text"). A wide variety of state, county, and township route shields accurately reflect the distinctions made by road signs while maintaining legibility at a small scale.
  • Along a concurrency, each route shield is placed as a single unit but laid out along the path of the roadway. This is the preferred approach of cartographers and geographers.[3]
  • Expressways (expressway=*) are given extra prominence regardless of road classification.
  • At lower zoom levels, streets are depicted as thin strokes corresponding to their centerlines, in contrast to the road casings found on European maps.[4]
  • Unpaved roads are distinguished by an alternating fill, in contrast to European maps that use an alternating fill to represent railways.[1]

Americana's use of MapLibre and OpenMapTiles differentiates it from previous open-source renderers used by the U.S. community:

Technical details

Americana is implemented as a MapLibre style that loads OpenMapTiles vector tiles. Unlike most styles, this style is assembled on page load in JavaScript code using a mechanism called runtime styling. Accompanying runtime styling code draws shield images on demand. The demo page loads MapTiler-hosted vector tiles by default, but the style is compatible with any OpenMapTiles-compliant tileset, including those generated by Planetiler.

How to contribute

If you are interested in contributing to these or other aspects of the renderer, please join the #american-map-style channel in OSMUS Slack, or start a discussion on GitHub. Bug reports and pull requests are welcome.

See also

Notes and references

Further reading

  • Sperlongano, Brian (April 1, 2022). “An American Map Style”. State of the Map U.S. 2022. Tucson, Arizona: OpenStreetMap U.S.  YouTube Logo

External links