Skip to content

osm-americana/openstreetmap-americana

Repository files navigation

OpenStreetMap Americana

A quintessentially American map style 🗺 View the map

Americana map style logo

The United States of America is such a glorious mess of contradiction, such a crazy quilt of competing themes, such a fecund mishmash of people and ideas, that defining us is pretty much pointless. There is, of course, a kind of faded notion of "Americana", one that concerns Route 66, diners, freak rock formations, and the like—but even in its halcyon days this "roadside attraction" version of America was never an accurate or nuanced distillation of our massively complicated culture.
-Hampton Sides, Americana: Dispatches from the New Frontier (2004)


The purpose of the Americana style is to:

  • Promote collaboration and common purpose in OpenStreetMap’s American mapping community
  • Express the American experience through cartography, taking inspiration from the familiar features of North American paper maps
  • Challenge the status quo by showcasing innovation and invention

Americana has demonstrated or pioneered several cartographic techniques of importance to Americans that we hope will someday become commonplace among OpenStreetMap-based map styles:

  • Nuanced line styles help you distinguish roads, raiload tracks, and waterways based on a variety of intuitive characteristics.
  • Highway routes are identified by shields that resemble the signs on the road, with special support for roads that carry multiple routes concurrently.
  • Place labels throughout the world appear in both your preferred language and the local language, reflecting linguistic diversity both in the U.S. and abroad.
  • A dynamic legend communicates these design choices intuitively, regardless of the visual language you’re accustomed to.

We do this proudly in an open source project using vector tile technology.

How to use

You can install the OpenStreetMap Americana package and deploy it anywhere as a static webpage. For your convenience, we’ve deployed it on GitHub Pages. Click the Legend button to learn the meaning of each symbol, line, and color based on the features currently visible on the map.

The style tries to label places in your browser’s preferred language. To change this preference, consult your browser’s documentation: Chrome, Firefox, Safari for macOS, Safari for iOS. You can also override this preference by adding &language= to the URL, followed by a comma-separated list of IETF language tags. For example, here’s a map labeled in Portuguese, falling back to Spanish. If we don’t have the name of a place in any of your preferred languages, the style shows the name in the local language as a last resort.

Contributor’s guide

Contributors welcome!

The repository is organized as follows:

Some general guidelines:

  • Please follow the coding style guidelines described in each sub-folder. These guidelines are designed to make it easier for collaboration and reduce the chance of edit conflicts.
  • Innovation is encouraged! Please open a new ticket with your great ideas as a centralized focal point for discussion.
  • New contributors are welcome!
  • This style operates on the principle of consensus. Maintainers should ensure that changes represent a broad consensus within the American mapping community.
  • Maintainers are also responsible to ensure that this principle of consensus does not cause stagnation or inaction. Contributor time is valuable; accepting the responsibility of being a maintainer means committing to responding to issues and PRs on a reasonable timeline that encourages community participation.

Technology stack

The technology stack for this style can be summarized below:

Americana technology stack

The dynamic shield generator is included as a module in this repository and also published to npm.

Artifacts

  • Style users can use the maplibre StyleJSON, and sprite sheets (1x, 2x).
  • For highway shield library users, a ShieldJSON must be supplied to associate route networks with sprite images and drawn shield shapes.
  • The project taginfo.json lists which tags are used by the style.

Data sources

The OpenStreetMap Americana style is built upon the OpenMapTiles schema, which includes:

  • Feature data from OpenStreetMap
  • Translated name labels from Wikidata for places, POIs, airports, roads, bodies of water, parks, and mountain peaks.
  • Low-zoom ocean/water, boundary, and urbanized area data from Natural Earth.

The legend’s “Route markers” section is labeled using labels of Wikidata items that are tagged with the corresponding OSM tag.

Coverage

Americana is compatible with vector tiles covering the entire world.

Americana displays custom route shields for routes in all U.S. states and territories, and for routes in the following countries:

Countries

We are hoping that it will support more countries; you can help us!

Tile Server

Although the source code in this repository is dedicated to the public domain under a CC0 waiver, it is configured by default to load map tiles from an OpenStreetMap US hosted community tile server. OpenStreetMap US, the local chapter for OpenStreetMap in the United States, makes this server available for use by other hobbyist and community projects with constraints. See the tile server usage policy for more details. This usage policy describes the allowable usage of the tiles for other projects, separate from this style or the application being developed in this repository.