A quintessentially American map style 🗺 View the map
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 AARoads Wiki features this fork of OpenStreetMap Americana in countless infoboxes and other contexts, making it easy for visitors to find their bearings as they read the mellifluous article text. Americana was chosen for its reliance on freely licensed, community-maintained OpenStreetMap data, its use of modern map technology, and its adherence to a visual style that North American roadgeeks would feel right at home in.
This fork retains Americana’s characteristic shields but tweaks the colors to match a color scheme for static maps that the AARoads Wiki’s predecessor, the English Wikipedia’s WikiProject U.S. Roads, adopted in 2006 with minor subsequent adjustments.
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.
Contributors welcome!
The repository is organized as follows:
- src/ - The map style. See CONTRIBUTING.md.
- dev/ - Development tools used for style development. See Style Developer Tools
- test/ - Automated unit tests.
- shieldlib/ - Maplibre shield rendering library (npm entry).
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.
The technology stack for this style can be summarized below:
The dynamic shield generator is included as a module in this repository and also published to npm.
- 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.
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.
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:
We are hoping that it will support more countries; you can help us!
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.