# zinc-style

**Repository Path**: mirrors_tangrams/zinc-style

## Basic Information

- **Project Name**: zinc-style
- **Description**: DEPRECATED: Use https://github.com/tangrams/refill-style/ instead
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: gh-pages
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-26
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DEPRECATED

Use https://github.com/tangrams/refill-style/ instead, loading `themes/color-zinc.zip` instead.


# Tangram Zinc Style

**Zinc** is a light gray style optimized for data visualization overlays. Give [OpenStreetMap](http://www.openstreetmap.org/) data a professional basemap skin using the [Tangram](http://github.com/tangrams/tangram) graphics library and Mapzen's versatile [Vector Tiles](https://mapzen.com/projects/vector-tiles/). 

Mapzen's Zinc style is comparable to Esri's [light gray Canvas](http://blogs.esri.com/esri/arcgis/2011/09/29/esri-canvas-maps-part-i-author-beautiful-web-maps-with-our-new-artisan-basemap-sandwich/) style, Mapbox's [Light](https://www.mapbox.com/blog/custom-styles-mapbox-streets/) style, and CartoDB's [Positron](http://content.stamen.com/new_maps_for_cartodb) by Stamen style. If you like any of those, Mapzen's Zinc basemap style is for you. Please use and adapt the open source scene file in your own projects!

**Looking for help?** There is a mini tutorial after the preview image below walking thru [Vector Tiles API key signup](https://github.com/tangrams/zinc-style-no-labels/blob/gh-pages/README.md#sign-up-for-a-vector-tiles-api-key) and [building a Leaflet map](https://github.com/tangrams/zinc-style-no-labels/blob/gh-pages/README.md#building-a-leaflet-map-using-tangram-and-this-scene-file) using Tangram and this repo's scene file.

### A family of styles with many flavours

Mapzen offers the Zinc style in three flavors:

2. **Default** (this repo) - Some labels for streets, cities, water bodies, and some big parks with name only (no icons). No business labels. Good for data visualization overlays that need to provide some location context.
1. **[More labels](https://github.com/tangrams/zinc-style-more-labels)** - Full set of labels, including high contrast icons highlighting OpenStreetMap business listing data.
3. **[No labels](https://github.com/tangrams/zinc-style-no-labels)** - Just the lines and polygons, please. 

**Looking for a different style?** We offer a range of styles including [Refill](https://github.com/tangrams/refill) (high contrast black & white cartography) and [Cinnabar](https://github.com/tangrams/cinnabar-style) (classic color cartography). 


**Live Zinc demo:** http://tangrams.github.io/zinc-style-some-labels

![zinc-style-some-labels-preview](https://cloud.githubusercontent.com/assets/853051/11136794/c8c54190-8966-11e5-9017-b7f06d6841bb.png)


## Developer resources

**So how do you actually use this stuff?** Tangram styles are called "scenes" and are written in YAML. The scene file (e.g.: [zinc-style-some-labels.yaml](https://github.com/tangrams/zinc-style-some-labels/blob/gh-pages/zinc-style-some-labels.yaml)) requires a vector tile source. To use Mapzen's vector tile service you must first obtain a free developer API key and update your scene file with that key. 

### Sign up for a Mapzen Vector Tiles API key

**Mapzen Vector Tiles are a free, shared tile service.** As such, there are generous limitations on requests to prevent individual users from degrading the overall system performance.

1. Go to https://mapzen.com/developers.
2. Sign in with your GitHub account. If you have not done this before, you need to agree to the terms first.
3. Create a new key for Vector Tiles, and optionally, give it a project name so you can remember the purpose of the key.
4. Keep the web page open so you can copy the key into your source code later.

### Building a Leaflet map using Tangram

Using Tangram and Mapzen's Vector tiles inside the popular [Leaflet](http://leafletjs.com) mapping framework is easy. We'll make it even easier soon to do this via a Leaflet [provider](https://github.com/leaflet-extras/leaflet-providers), but in the meantime...

1. Update your copy of the scene file on [line 456](https://github.com/tangrams/zinc-style-some-labels/blob/gh-pages/zinc-style-some-labels.yaml#L456) to reference the API key you created in Step 3 in the **Sign up** section above. 
`url:  //vector.mapzen.com/osm/all/{z}/{x}/{y}.topojson?api_key=vector-tiles-{your-api-key-here}`
2. Reference the [index-demo.html](index-demo.html) file in any of the style repos for how to configure Leaflet with Tangram and the scene file (e.g.: [Zinc](http://github.com/tangrams/zinc-style-some-labels)). 
3. Looking for a more sophisticated implementation that includes basic search? The main [index.html](index.html) file has a more real world example.
4. Need help testing your map locally? See the README in each repo.
5. Wondering where to host your map? Make a public repo on Github (or fork ours!) and enjoy their [GitHub Pages](https://pages.github.com) to github.io magic dance.

### Tangram resources

1. [Procedural Cartography with Tangram](https://github.com/mapzen/presentations/tree/master/08-2015-JSGEO) Patricio's presentation notes from [JS.Geo](http://www.jsgeo.com) metope last month.
2. [Walkthrough: Make a map with Tangram](https://mapzen.com/documentation/tangram/walkthrough/) by Rhonda on Mapzen's documentation team.

### To run locally

Want to modify the style to fit your needs? Clone or downloaded the repo locally. Then...

Start a web server in the repo's directory:

    python -m SimpleHTTPServer 8000
    
If that doesn't work, try:

    python -m http.server 8000
    
Then navigate to: [http://localhost:8000](http://localhost:8000), which loads the [index.html](index.html) file.


**You should be all set, happy mapping!** But please let us know at [hello@mapzen.com](mailto:hello@mapzen.com) or via Twitter [@mapzen](http://twitter.com/mapzen) if you encounter any funk and we'll help you get up and running.

### See also:

* Blog post announcing this style...