LogoLogo
  • Welcome
  • What's new?
  • Docs
    • User guides
      • Get Started
      • Kepler.gl workflow
        • Add data to layers
          • Adding Data Layers
          • Create a Layer
          • Blend and Rearrange Layers
          • Hide, Edit and Delete Layers
        • Add Data to the Map
      • Layers
        • Point
        • S2 Layer
        • Icon
        • Line
        • Cluster
        • Polygon
        • Hexbin
        • Grid
        • H3
        • Heatmap
        • Arc
        • Trip layer
      • Layer Attributes
      • Color Palettes
      • Filters
      • Map Styles
      • Interactions
      • Map Settings
      • Time Playback
      • Save and Export
      • FAQ
    • API Reference
      • ecosystem
      • Get Started
      • Advanced usages
        • Saving and Loading Maps with Schema Manager
        • Replace UI Component with Component Dependency Injection
        • Forward Dispatch Actions
        • Reducer Plugin
        • Using Updaters
        • Custom reducer initial state
        • custom-mapbox-host
      • Components
      • Reducers
        • reducers
        • map-style
        • map-state
        • combine
        • overview
        • ui-state
        • vis-state
      • Processors
        • All processors
      • Schemas
      • Actions
        • All actions
      • Cloud providers
        • Provider
      • Custom theme
      • Localization
    • Jupyter Notebook
  • Examples
    • Node/Express
    • Demo App
    • Open modal
    • Open modal
    • UMD client
    • Customize kepler.gl Theme
    • Customize kepler.gl Reducer
  • Contributing
    • Developing Kepler.gl
    • Contributor Covenant Code of Conduct
  • Change Log
  • Upgrade Guide
Powered by GitBook
On this page
  • Types of Layers
  • Single Feature Layers
  • Point
  • Arc
  • Line
  • Hexbin
  • Heatmap
  • Cluster
  • Icon
  • Grid
  • GeoJSON
  • H3
  • S2 Layer
  • Vector Tile Layer
  • Raster Tile Layer

Was this helpful?

  1. Docs
  2. User guides

Layers

PreviousAdd Data to the MapNextPoint

Last updated 20 days ago

Was this helpful?

Types of Layers

Single Feature Layers

Single feature layers renders 1 feature

Point

Point layer

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

Hexbin

Hexbin aggregates points into hexagons. The counts can be represented through color and/or height.

Layer Attributes: Color/ Color Based On, Filter by Count Percentile, Opacity, Hexagon Radius (km), Coverage (Radius), Enable Height, Elevation Scale/ Height Based On, 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

Icon

Icon layers are a type of point layer. They allow you to differentiate between points by assigning icons to points based on a field. For example, you might use icons to differentiate between types of venues and points of interest.

Layer Attributes: Color, Radius, Label, High Precision Rendering

To see the icon menu, create a new icon layer and click how to draw an icon layer:

Grid

Grids layers are similar to heatmaps. They show the density of points. They provide visual discrepancy in a map where multiple heatmap-style layers are present.

Layer Attributes: Color, Radius, Height, High Precision Rendering

GeoJSON

H3

S2 Layer

To use S2 layer, you need to assign a column containing S2 tokens.

Vector Tile Layer

Vector Tile Layer makes it possible to visualize very large datasets through MVTs (Mapbox Vector Tiles). To optimize performance, the layer only loads and renders tiles containing features that are visible within the current viewport.

Supported URL templates:

  • MVT (https://api.mapbox.com/v4/mapbox.mapbox-streets-v8/{z}/{x}/{y}.mvt?access_token=your-mapbox-acceess-token)

  • pmtiles (https://your-cdn/filename.pmtiles)

Raster Tile Layer

Raster layers are used to show satellite and aerial imagery. They allow you to work interactively directly with massive, image collections stored in .pmtiles (in raster format) or Cloud Optimized GeoTIFF format.

Supported URL templates:

  • Users can reference remote .pmtiles files in raster format for raster layers by supplying a direct link to the file.

  • Cloud-Optimized GeoTIFFs (COG) can also be used in raster layers by providing standardized Spatio-Temporal Asset Catalog (STAC) metadata.

    • The metadata file must be a valid STAC Item or STAC Collection, version 1.0.0 or higher.

    • Raster data referenced in STAC assets should be Cloud-Optimized GeoTIFFs and need to be publicly accessible via HTTPS.

    • STAC item and collections must have Electro-Optical and Raster extensions, and at least one asset must have both eo:bands and raster:bands information. common_name must be provided in eo:bands and data_type must be provided in raster:bands.

    • Users must use their own instances of raster tile servers, such as Titiler. [TODO: add instructions]

Arc layer
Line layer
Hexbin layer
Heatmap layer
Cluster layer
Icon layer
How to Draw Icon Layer
Grid layer
3D Grid layer
GeoJSON layer
Polygon geoJSON layer

GeoJSON layers can display either paths, polygons or points. For example, a path GeoJSON layer can display data like trip routes. A polygon GeoJSON layer is essentially a layer and works best for rendering geofences. To add a GeoJSON layer, your dataset must contain geometry data.

H3 layer - contour

H3 layers visualize spatial data using .

To use H3 layer, you need a hex_id in your dataset, which can be generated using from latitude, longitude and resolution.

S2 Layer

choropleth
H3 Hexagonal Hierarchical Spatial Index
h3-js
Back to table of contents