Crater Lake National Park


Digital maps for the National Park Service

Modest Maps Base API

As a user of the NPMap library, you are responsible for complying with the terms of service for whichever base API(s) and base map/geocoding/routing services you consume in your map.

The version of Modest Maps that NPMap uses is updated frequently, and, for the most part, closely mirrors the Master branch. You can view the full API documentation here:

Pros and Cons

Here is a list of some of the strengths and weaknesses of the modestmaps base API. This is an opinionated take based on our own experience working with the library.


  • Lightweight and mobile-friendly
  • Works extremely well when used in conjunction with TileStream layers
  • Open source means it is easy to extend the out-of-the-box functionality


  • API is buggy in places
  • Documentation still needs some work
  • Not much built-in functionality, meaning you have to write your own code to integrate geocoding/routing, etc.


Modest Maps is available as open source software, so no license is required.


No credentials are required.


The modestmaps base API depends on the following open source libraries:

  1. Wax

Base Layers

The following default base layers are available when utilizing the modestmaps base API:

  type: 'Aerial' // MapBox aerial tiles
  type: 'Blank' // No tiles
  type: 'Hybrid' // MapBox hybrid tiles
  type: 'Streets' // MapBox streets tiles
  type: 'Terrain' // MapBox terrain tiles

These base layers can be added to your map via the NPMap.config.baseLayers config. You can also add other layer types (e.g. ArcGisServerRest, TileStream, etc.) as base layers to your map.

If the baseLayers config is not specified in the NPMap.config object, NPMap will default the base layer to type: 'Streets'.


Here's a link to a filtered list for the modestmaps base API examples in the support documentation examples gallery: