Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
CartoDB javascript library
tag: 2.0.9

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
demos
doc
examples
scripts
src
test
themes
vendor
.gitignore
Makefile
README.md
index.js
package.json

README.md

cartodb.js

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

quick start

  1. add cartodb.js and css to your site (and google maps if you are using it):

        <link rel="stylesheet" href="http://libs.cartocdn.com/cartodb.js/v2/themes/css/cartodb.css" />
        <!--[if lte IE 8]>
            <link rel="stylesheet" href="http://libs.cartocdn.com/cartodb.js/v2/themes/css/cartodb.ie.css" />
        <![endif]-->
    
        <script src="https://maps.googleapis.com/maps/api/js?sensor=false"></script>
        <script src="http://libs.cartocdn.com/cartodb.js/v2/cartodb.js"></script>
    
        <!-- use these links if you are using https -->
        <!--
    
        <link rel="stylesheet" href="https://d3voyrscnb0slx.cloudfront.net/cartodb.js/v2/themes/cartodb.css" />
        <!--[if lte IE 8]>
            <link rel="stylesheet" href="https://d3voyrscnb0slx.cloudfront.net/cartodb.js/v2/themes/css/cartodb.ie.css" />
        <![endif]-->
    
        <script src="https://d3voyrscnb0slx.cloudfront.net/cartodb.js/v2/cartodb.js"></script>
        -->
  2. create the map and add the layer

    gmaps

        // create google map
        var map;
        var mapOptions = {
          zoom: 7,
          center: new google.maps.LatLng(43, -68),
          mapTypeId: google.maps.MapTypeId.ROADMAP
        };
        map = new google.maps.Map(document.getElementById('map'),  mapOptions);
    
        // add the cartodb layer
        // you can find this url in CartoDB interface:
        // - go to map
        // - click on share
        // - API tab
        var layerUrl = 'http://examples-beta.cartodb.com/api/v1/viz/219/viz.json';
        cartodb.createLayer(map, layerUrl, function(layer) {
            map.overlayMapTypes.setAt(0, layer);
        });
    

    leaflet

      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://examples-beta.cartodb.com/api/v1/viz/219/viz.json';
      cartodb.createLayer(map, layerUrl, function(layer) {
        map.overlayMapTypes.setAt(0, layer);
      });

next steps

how to build

```
open test/SpecRunner.html
make release
```
Something went wrong with that request. Please try again.