MAPPING WITH KEPLER.GL

Getting Started


Kepler.gl is a tool designed for geospatial data analysis. This guide will help you get started creating visualizations in kepler.gl.

Add Data to your Map

Kepler.gl will prompt you to add data to your map as soon as you open the web page.

kepler.gl is a pure client side app. Data lives only in your machine/browser. No information or maps is sent back up to our server.

Upload your own CSV or GEOJSON file, or add kepler.gl sample data. Sample data is a great way to explore and get familiar with kepler.gl’s features.

Add Layers

Open the Data Layers menu to start building your visualization. Layers are simply data visualizations that can be built on top of one another. Layers of the same type can differ greatly in appearance depending on how they’re configured, opening up new possibilities for data analysis.

Types of Layers

Point

Point layers draw points for a given event or object based on its location – latitude and longitude.

Arc

Arc layers draw an arc between two points. They’re useful for visualizing the distance between two points as well as comparing distances in 3D. Note that arc layers don’t show routes between points, but simply the distance between the two points. The tallest arc represents the greatest distance.

To draw arcs, your dataset must contain the latitude and longitude of two different points for each arc.

Layer Attributes: Color/ Color Based On, Opacity, Stroke Width/ Stroke Based On, High Precision Rendering

Line

Line layers are the 2D version of arc layers. Both draw a line between two points to represent distance, but in a line layer, the drawing lies flat on the map.

Layer Attributes: Color, Stroke, High Precision Rendering

Heatmap

Heatmap is a graphical representation of data in which data values are represented as colors.

Layer Attributes: Color, Opacity, Radius, Weight

Cluster

Cluster layers visualize aggregated data based on a geospatial radius.

Layer Attributes: Color, Cluster Size

Add Filters

Add filters to your map to limit the data that is displayed. Filters must be based on the columns in your dataset. To create a new filter, open the Filter menu and click Add Filter. Note that filters apply to all layers and cannot be toggled on and off.

  1. Select Filters from the right navigation bar
  2. The Filters panel displays the list of existing filters, color-coded by dataset. To create a new filter, Click Add Filter.
  3. Choose a dataset, and then a field on which to filter your data. Filter values are defined by field data type (number, string, timestamp, etc.).
  4. Your filter is applied to your map as soon as you specify the field and value.
  5. Delete a filter anytime by clicking the trashcan to the right of the filter you wish to delete.

Note: filters apply to all layers in the same dataset on your map.

Customize Map Settings

Change the settings on your map in the Interactions and Base Map menus. Customization options include tooltips, brush highlighting, base map style, map imagery toggles (water, parks, satellite image, etc.), and many more.

Base Map Styles

Open the Base Map panel to select from a list of default map styles. Options include:

  • Dark: dark base map with light-colored text.
  • Light: light base map with dark-colored text.
  • Muted Light
  • Muted Dark

Map Settings

Split Maps

You can display a side-by-side comparison of the same map area with different layers with the Split Map functionality.

  1. Enable this by clicking the Split Map icon in the top right corner of your map
  2. Toggle the layers visible in each map with the layer icon in the top right corner of each map

View Maps in 3D

View your map in 3D by clicking the 3D icon in the top right corner of your map

Time Slider

Add a filter based on a time-related field, like timestamp.

The playback window will appear on the bottom of the map. The bars are distribution graphs of all data points by time. Select the desired rolling time window

Press play to start the video. Click on the speed value and select/input your desired value 1x, 2x, 4x on the top right to change the playback speed.

Choose custom y axis. You can click Select Y Axis to change the default distribution graph to a timeseries of selected column.

Save and Export

kepler.gl is a client-side only application. In the demo app, the data you uploaded stays in your browser. Uber does not send or store any user data to any backends. This rule poses an limitation on how you can save and share your maps.

However, in the demo app, you can:

Export Image

You can export the current map as an image. The export window will use the current map viewport, and the preview will show the entire exported map area. To adjust the viewport, you will have to close the export dialog. You can choose different export ratios or resolutions, and also to add a map legend.
To save and export your current map as HTML file, click on Export Map and subsequently on Export. When prompted provide your own Mapbox token to be used in the newly generated file. If you don’t provide a Mapbox Token, Kepler.gl will use a default one which can expire at anytime without any communication and therefore break your your existing map.

Save your map as an image, export current map data, export current map as a json file to be load back into kepler.gl.

Leave a comment

Your email address will not be published. Required fields are marked *