D3 Tips and Tricks v4

Saturday, 15 February 2014

Using the Stamen.Watercolor tile server with leafet.js

The following post is a portion of the Leaflet Tips and Tricks book which is free to download. To use this post in context, consider it with the others in this blog or just download the the book as a pdf / epub or mobi .


The ‘Stamen.Watercolor’ tiles are a beautiful watercolor themed series of maps based on (I believe) OpenStreetMap data.
The tiles are distributed by the good folks at Stamen who also support a mapping solution / thingy called Map Stack and do some astonishing design work.

URL Template


Usage policy

I couldn’t locate any official guidance on usage, so I’m going to make the assumption that any use should fall into the ‘reasonable’ category and advise that if you are thinking of using their maps for anything remotely ‘substantial’ or commercial that you contact them.


If using the Stamen.Watercolor tiles, appropriate copyright attribution is required to OpenStreetMap. Additionally in spite of not finding any official guidance on their web site, it would seem appropriate (at a minimum) that recognition of the source as ‘Stamen Design’ with a link would be required. Again, if you are considering using their tiles for any kind of commercial project, you should contact them.

Usage example

        mapLink = 
            '<a href="http://openstreetmap.org">OpenStreetMap</a>';
        wholink = 
            '<a href="http://stamen.com">Stamen Design</a>';
            'http://{s}.tile.stamen.com/watercolor/{z}/{x}/{y}.jpg', {
            attribution: '&copy; '+mapLink+' Contributors & '+wholink,
            maxZoom: 18,
Stamen.Watercolor map

More Examples

I will post separate examples of the usage of different tile servers as separate posts. Or you can find them all in Leaflet Tips and Tricks.

The description above (and heaps of other stuff) is in the Leaflet Tips and Tricks book that can be downloaded for free (or donate if you really want to :-)).

1 comment: