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.
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.
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 layers draw points for a given event or object based on its location – latitude and longitude.
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 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 is a graphical representation of data in which data values are represented as colors.
Layer Attributes: Color, Opacity, Radius, Weight
Cluster layers visualize aggregated data based on a geospatial radius.
Layer Attributes: Color, Cluster Size
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.
- Select Filters from the right navigation bar
- The Filters panel displays the list of existing filters, color-coded by dataset. To create a new filter, Click Add Filter.
- 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.).
- Your filter is applied to your map as soon as you specify the field and value.
- 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
You can display a side-by-side comparison of the same map area with different layers with the Split Map functionality.
- Enable this by clicking the Split Map icon in the top right corner of your map
- 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
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 map as an image.
- Export filtered or unfiltered data as a csv.
- Export Map
- Share Public URL (Dropbox)
Save your map as an image, export current map data, export current map as a json file to be load back into kepler.gl.