cartodb.js

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:

``html





`


2. Create the map and add the layer

`javascript
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);
`

$3

You can install cartodb.js with bower by running

`sh
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

- 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.