Long-term support for Mapzen maps, vector & terrain tiles

As Mapzen hosted services enter final shutdown we’re proud to offer long-term support for the maps, basemap designs, and the vector and terrain tile data that has powered Mapzen’s cartography. To enjoy the maps into the future, you’ll need to sign up for a Nextzen API key today, and make a few updates to your projects.

This page details new long-term support endpoints for various map display related services and libraries, and provides information on accessing the new requester pays S3 bucket which features archival December 2017 vector tiles for the entire world.

See it all together at

Mapzen basemap styles


Importing a Basemap

All basemaps have been updated to use the new Nextzen sources, but you’ll need to import a new major version from a new web location.

For example, this Tangram scene file example imports Refill, adds Blue as a color theme, shows more labels, using the new Nextzen endpoints:



The updated basemap scenes files also include many new icons and a few bug fixes, and are fully documented below.

Tangram logo


Rendering maps with Tangram JS

The basemaps are written in the Tangram scene file syntax, and the Tangram JS library is available for import to your Javascript projects via a new Nextzen endpoint:

<script type="text/javascript" src=""></script>

Tangram JS, Tangram ES, and Tangram Play remain open source projects.

NOTE: The Mapzen.js wrapper around Tangram is not currently ported over to Nextzen. Stay in touch if that’s important to you.

Vector tiles are the future


Vector Tiles

If you were using Tilezen vector tiles via the Mapzen Vector Tile service you’ll need to get an API key (more on that later, learn more) and update your endpoints to the new Nextzen locations:{tilesize}/all/{z}/{x}/{y}.mvt?api_key=your-nextzen-api-key{z}/{x}/{y}.mvt?api_key=your-nextzen-api-key{z}/{x}/{y}.mvt?api_key=your-nextzen-api-key{z}/{x}/{y}.mvt?api_key=your-nextzen-api-key

We’re also making an entire global vector tile build, based on December 2017 data, available as a requester pays S3 endpoint:


To access the Tilezen vector tiles you’ll need to run the same middleware called Tapalcatl-py that powers the service. Tapalcatl reads the hashed-x-y-z-coordinate metatiles (which group many tiles together in one ZIP archive) and extracts and returns the requested tile in the correct format (MVT, GeoJSON, and TopoJSON) and tile size (256 and 512 pixel).

Tapalcatl is similar to TileLive and other MBTiles based servers that vastly reduce financial costs associated with S3 gets and puts. This minimizes what would otherwise be billions of individual files, while introducing just a few milliseconds of latency at the edge. Amazon S3 GET pricing in us-east is currently $0.004 per 10,000 requests, and running Lambda and/or CloudFront on top of that adds only a little bit more.

Instructions for running Tapalcatl as an AWS Lambda function with Zappa are included in the project’s readme and enable a “serverless” (i.e.: low maintenance and generally cheap) way to serve vector tiles. Or join our mailing list if you’d like information about hosted instances or future data updates.

Terrain tile raster is faster


Terrain Tiles

If you were using Tilezen terrain tiles via the Mapzen Terrain Tiles service you’ll need to get an API key and update your endpoints to the new Nextzen locations:{tilesize}/terrarium/{z}/{x}/{y}.png?api_key=your-nextzen-api-key{tilesize}/normal/{z}/{x}/{y}.png?api_key=your-nextzen-api-key{z}/{x}/{y}.tif?api_key=your-nextzen-api-key{N|S}{y}/{N|S}{y}{E|W}{x}.hgt.gz?api_key=your-nextzen-api-key

You can still access the Tilezen terrain tiles in 256 sized tiles via the existing Amazon public dataset S3 endpoints:


The 512 and buffered 260 and 516 sized terrain tiles are made possible by running Zaloa as a Lambda function.


All together now…

The following versions of the Tangram basemap styles introduce support for Nextzen sources:

  • Bubble Wrap: 9.0.0
  • Cinnabar: 9.0.0
  • Refill: 11.0.0
  • Tron: 6.0.0
  • Walkabout 7.0.0
  • SDK Deault 1.1.0

New Nextzen basemap endpoints:



Icon Library: sprites on their own

The full Icon Library is available for use in your favorite mapping or graphics software as individual sprite images, independent of the basemaps. Currently only png format at 2x resolution is supported.


For example:

Load the adit sprite in the Bubble Wrap style at 2x in png format:

Bubble Wrap adit


Thank you

It’s been a pleasure serving you the last few years! If you’d like to continue or otherwise sponsor the Tilezen open source project let us know :)

See you on the other side!


PS: Show me the icons

This release of the basemaps and stand-alone icon libraries triples the number of map icons, with 100% interoperability with the Maki icon set, the default cartography, the HOT icon set, and adds icons for all Tilezen POI kinds. (When there is a name discrepancy between Tilezen and Maki, for instance, we re-export the same artwork per name variant.) We also added nearly 200 shields, each with 5 character widths to support localized road shields in more than 40 countries.

The artwork is available in 3 different styles: Bubble Wrap full color, Walkabout silhouettes, and Refill’s greyscale. We were lucky to contract with the extraordinary Denis Sazhin of iconka to extend Geraldine’s original set of icons. The raw Illustrator files is also available under an open license, please use the artwork far and wide :)

  • 674 map and ux icons
  • 958 road shields
    • 290 United States road shields for all 50 states, US Routes, US Interstates, county routes, US Forest Service highways and roads, and more.
    • 668 international road shields, including in: Argentina, Australia, Austria, Bangladesh, Belgium, Brazil, Canada (including all provinces), Chile, China, Denmark, Finland, France, Germany, Greece, India, Indonesia, Iraq, Ireland, Italy, Japan, Luxembourg, Malaysia, Mexico, Netherlands, New Zealand, Norway, Peru, Poland, Portugal, Romania, Russia, Saudi Arabia, Singapore, South Africa, South Korea, Spain, Sweden, Switzerland, Thailand, Turkey, Ukraine, United Kingdom, and Vietnam.
Bubble Wrap icons
Bubble Wrap USA road shields
Bubble Wrap international road shields