November 22, 2018

324 words 2 mins read



WebGL2 powered geospatial visualization layers

repo name uber/
repo link
language JavaScript
size (curr.) 211508 kB
stars (curr.) 7300
created 2015-12-15
license MIT License



npm install

Using offers an extensive catalog of pre-packaged visualization “layers”, including ScatterplotLayer, ArcLayer, TextLayer, GeoJsonLayer, etc. The input to a layer is usually an array of JSON objects. Each layer offers a highly-flexible API to customize how the data should be rendered.

Example constructing a ScatterplotLayer:

import {ScatterplotLayer} from '';

 * data is an array of object in the shape of:
 * {
 *   "name":"Montgomery St. (MONT)",
 *   "address":"598 Market Street, San Francisco CA 94104",
 *   "entries":"43430",
 *   "exits":"45128",
 *   "coordinates":[-122.401407,37.789256]
 * }
const scatterplotLayer = new ScatterplotLayer({
  id: 'bart-stations',
  data: '',
  getRadius: d => Math.sqrt(d.entries) / 100,
  getPosition: d => d.coordinates,
  getFillColor: [255, 228, 0],

Using with React

import DeckGL from '';

  initialViewState={{longitude: -122.4, latitude: 37.78, zoom: 8}}
  layers={[scatterplotLayer]} />

Using with Pure JS

import {Deck} from '';

const deck = new Deck({
  width: '100vw',
  height: '100vh',
  initialViewState: {
    longitude: -122.4,
    latitude: 37.78,
    zoom: 8
  controller: true,
  layers: [scatterplotLayer]

Minimum setups of end-to-end usage is also showcased in the hello-world examples, using both webpack and browserify, so you can choose which bundler you prefer or are more familiar with.

To learn how to use through the many examples that come with the repo, please clone the latest release branch:

git clone -b 7.3-release --single-branch

For the most up-to-date information, see our API documentations


PRs and bug reports are welcome, and we are actively opening up the roadmap to facilitate for external contributors.

Note that once your PR is about to be merged, you will be asked to register as a contributor by filling in a short form.


Data sources

Data sources are listed in each example.

The project is supported by

comments powered by Disqus