Tangram is a JavaScript library for rendering 2D & 3D maps live in a web browser with WebGL. It is tuned for OpenStreetMap but supports any source of GeoJSON/TopoJSON or binary vector data, including tilesets and single files.
Here's a simple demo (repo here) with a basic example of a Tangram map.
The current version of Tangram can be included in your page with:
<script src="https://mapzen.com/tangram/tangram.min.js"></script>
The library includes a Leaflet plugin, Tangram.LeafletLayer, to provide basic web map pan/zoom functionality.
Data sources, layers, and styling rules are written in a scene file (here's an example). Armed with a scene file like scene.yaml, you can create a Tangram scene and add it to a Leaflet map like so:
var map = L.map('map');
var layer = Tangram.leafletLayer({ scene: 'scene.yaml' });
layer.addTo(map);
Read on for more info, or see the documentation.
simple-demo - A minimal demo showing the basic setup
highways-demo - Zoom-dependent styles and contextual filtering rules
gui-demo - Control styles in real-time with a gui
shaders-demo - Simple glsl shaders
Tangram-sandbox - More complex glsl shaders
Instead of loading traditional bitmap tiles, Tangram draws its own tiles from scratch, based on vector tiles that contain the source data.
Mapzen provides a free vector tile service extracted from OpenStreetMap and Natural Earth data, with worldwide coverage updated continuously -- sign up for an API key here. There is also an OSM.US-hosted alternative.
Tangram currently supports GeoJSON & TopoJSON-based tiles, as well as Mapbox's binary format, all of which are available from the Mapzen vector tile service. (Here's an example GeoJSON tile.)
The scene file is where you specify data sources and layers, filter the data, and define and apply styles. (In our demos, this file is named scene.yaml.) The rules for doing these things are many and various, but the basics are pretty easy, and they are all meticulously documented in the Tangram Documentation https://github.com/tangrams/tangram-docs.
The scene file is written in YAML, which is a data-serialization format like JSON, but with less punctuation. Instead, data structures are specified with whitespace, like Python. One neat side benefit is that the format is super friendly to strings, which means you can write inline JavaScript and GLSL code straight into the scene file, without needing to wrap it in quotes or concatenate anything.
For questions, comments, suggestions, or to report a bug, please open a new issue.
Tangram is open-source, and we eagerly welcome feedback, feature requests, and contributions. We’re especially interested to see your maps, no matter how simple! Send screenshots, links, and any questions to [email protected].
For instructions, see CONTRIBUTING.md.
Tangram is an open-source project sponsored by Mapzen.