Multiple choropleth maps

Joining JSON data to a GeoJSON file and transitioning between different data visualizations.

<!DOCTYPE html>
<meta charset=utf-8 />
<title>Multiple choropleth maps</title>
<meta name='viewport' content='initial-scale=1,maximum-scale=1,user-scalable=no' />
<script src=''></script>
<link href='' rel='stylesheet' />
  body { margin:0; padding:0; }
  #map { position:absolute; top:0; bottom:0; width:100%; }
.menu-ui {

/* Do a fancy data transition for browsers that support it */
path {
  -webkit-transition:fill 200ms;
          transition:fill 200ms;

<div id='map'></div>
<div id='variables' class='menu-ui'></div>

<!-- jQuery is required for this example. -->
<script src=''></script>
L.mapbox.accessToken = '<your access token here>';
var map ='map')
    .setView([40, -96], 4)

// Be nice and credit our data source, Census Reporter.
map.attributionControl.addAttribution('Data from ' +
  '<a href="">' +
  'Census Reporter</a>');

// Choropleth colors from
// You can choose your own range (or different number of colors)
// and the code will compensate.
var hues = [

// The names of variables that we'll show in the UI for
// styling. These need to match exactly.
var variables = [
    'B06011002 - Born in state of residence',
    'B06011003 - Born in other state of the United States',
    'B06011004 - Native; born outside the United States'];

// Collect the range of each variable over the full set, so
// we know what to color the brightest or darkest.
var ranges = {};
var $select = $('<select></select>')
    .on('change', function() {
for (var i = 0; i < variables.length; i++) {
    ranges[variables[i]] = { min: Infinity, max: -Infinity };
    // Simultaneously, build the UI for selecting different
    // ranges
        .attr('value', variables[i])

// Create a layer of state features, and when it's done
// loading, run loadData
var usLayer = L.mapbox.featureLayer('/mapbox.js/assets/data/us.geojson')
    .on('ready', function () {

// Grab the spreadsheet of data as JSON. If you have CSV
// data, you should convert it to JSON with
function loadData(geojson) {
        .done(function (data) {
            joinData(data, geojson);

function joinData(data, usGeoJSON) {

    var byState = {};

    // Rearrange the US GeoJSON so that instead of being a big array,
    // it's an object that is indexed by the state name,
    // that we'll use to join on.
    for (var i = 0; i < usGeoJSON.features.length; i++) {
        byState[usGeoJSON.features[i]] =
    for (i = 0; i < data.length; i++) {
        // Match the GeoJSON data (byState) with the tabular data
        // (data), replacing the GeoJSON feature properties
        // with the full data.
        byState[data[i].name].properties = data[i];
        for (var j = 0; j < variables.length; j++) {
            // Simultaneously build the table of min and max
            // values for each attribute.
            var n = variables[j];
            ranges[n].min = Math.min(data[i][n], ranges[n].min);
            ranges[n].max = Math.max(data[i][n], ranges[n].max);
    // Create a new GeoJSON array of features and set it
    // as the new usLayer content.
    var newFeatures = [];
    for (i in byState) {
    // Kick off by filtering on an attribute.

// Excuse the short function name: this is not setting a JavaScript
// variable, but rather the variable by which the map is colored.
// The input is a string 'name', which specifies which column
// of the imported JSON file is used to color the map.
function setVariable(name) {
    var scale = ranges[name];
    usLayer.eachLayer(function(layer) {
        // Decide the color for each state by finding its
        // place between min & max, and choosing a particular
        // color as index.
        var division = Math.floor(
            (hues.length - 1) *
            (([name] - scale.min) /
            (scale.max - scale.min)));
        // See full path options at
            fillColor: hues[division],
            fillOpacity: 0.8,
            weight: 0.5

to create your own custom map and use it in this example.
Use this example by copying its source into your own HTML page and replacing the Map ID with one of your own from your projects. Having trouble with JavaScript? Try out Codecademy or contact our support team.
Copy example