CartoDB.js (v3.15)

⚠️ CartoDB.js v3.15 is no longer being actively developed. Major bugs will be addressed as needed. ⚠️

🎉 You can check out the Beta release of CARTO.js v4 here! 🎉

This library allows to embed visualizations created with CartoDB in your map or website in a simple way.

Quick start

1. Add cartodb.js and css to your site:

<link rel="stylesheet" href="http://libs.cartocdn.com/cartodb.js/v3/3.15/themes/css/cartodb.css" />
<script src="http://libs.cartocdn.com/cartodb.js/v3/3.15/cartodb.js"></script>

<!-- use these cartodb.css links if you are using https -->
<!--link rel="stylesheet" href="https://cartodb-libs.global.ssl.fastly.net/cartodb.js/v3/3.15/themes/css/cartodb.css" /-->

<!-- use this cartodb.js link if you are using https -->
<!-- script src="https://cartodb-libs.global.ssl.fastly.net/cartodb.js/v3/3.15/cartodb.js"></script -->

2. Create the map and add the layer

var map = L.map('map').setView([0, 0], 3);

// set a base layer
L.tileLayer('http://a.tile.stamen.com/toner/{z}/{x}/{y}.png', {
  attribution: 'stamen http://maps.stamen.com/'
}).addTo(map);

// add the cartodb layer
var layerUrl = 'http://documentation.cartodb.com/api/v2/viz/2b13c956-e7c1-11e2-806b-5404a6a683d5/viz.json';
cartodb.createLayer(map, layerUrl).addTo(map);

Usage with Bower

You can install cartodb.js with bower by running

bower install cartodb.js

Documentation

You can find the documentation online here and the source inside this repository.

Examples

• Load a layer with google maps
• Load a layer with Leaflet
• Show a complete visualization
• A visualization with a layer selector
• How to create a custom infowindow
• The Hobbit filming location paths a full example with some widgets

How to build

Build CartoDB.js library:

• Install node.js, from 0.10 version
• Install grunt & bower: npm install -g grunt-cli bower
• Install node dependencies: npm install
• Install bower dependencies: bower install
• Install ruby and bundler
• Install ruby dependencies: bundle install (necessary for compass gem)
• Start the server: grunt build
• Happy mapping!

Submitting Contributions

You will need to sign a Contributor License Agreement (CLA) before making a submission. Learn more here.