h3TilesetSource

You can use h3TableSource to build layers and widgets using pre-generated CARTO tilesets stored in your data warehouse that contain:

• h3-based data: a column containing an h3 cell identifier

Usage

import {h3TilesetSource} from '@carto/api-client';

const data = h3TilesetSource({
  tableName: 'carto-demo-data.demo_tilesets.h3_tileset'
});

Options

type H3TilesetSourceOptions = {
  tableName: string;
  widgetWorker?: boolean;
};

• tableName: The fully qualified name (FQN) of the pre-generated tileset you want to retrieve from your data warehouse. For example, for a BigQuery connection, carto-demo-data.demo_tilesets.h3_tileset would be a valid table name.

• widgetWorker (optional): A boolean that enables or disables the use of Web Workers to perform clent-side calculations for widgets.

Response

The response of h3TilesetSource is a promise that can be resolved and used in layers and widgets.

Connection compatibility

Connection Data Warehouse	Compatible
BigQuery	✅
Snowflake	✅
Redshift	✅
Databricks	✅
PostgreSQL	✅
CARTO Data Warehouse	✅

Layer compatibility

h3TilesetSource is compatible with the following layers from the @deck.gl/carto module:

• H3TileLayer

Widget model compatibility

h3TilesetSource is compatible with the following widget models:

• getFormula

• getCategories

• getHistogram

• getRange

• getScatter

• getTimeSeries

• getTable

Widget models for tilesets are calculated client side. Precision might be lower, especially at low zoom levels (ie: when covering a large surface of the earth). Learn more about client-side widget calculations.