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