@carto/api-client 0.4.3 → 0.4.5-alpha.0

package/build/api-client.cjs

@@ -4,12 +4,6 @@ var union = require('@turf/union');
 var invariant = require('@turf/invariant');
 var helpers = require('@turf/helpers');
 
-function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
-
-var bboxClip__default = /*#__PURE__*/_interopDefaultLegacy(bboxClip);
-var bboxPolygon__default = /*#__PURE__*/_interopDefaultLegacy(bboxPolygon);
-var union__default = /*#__PURE__*/_interopDefaultLegacy(union);
-
 /**
  * @internal
  * @internalRemarks Source: @carto/react-core, @carto/constants, @deck.gl/carto
@@ -245,7 +239,7 @@ function createViewportSpatialFilter(viewport) {
   if (_isGlobalViewport(viewport)) {
     return;
   }
-  return createPolygonSpatialFilter(bboxPolygon__default["default"](viewport).geometry);
+  return createPolygonSpatialFilter(bboxPolygon(viewport).geometry);
 }
 /**
  * Returns a {@link SpatialFilter} for a given {@link Polygon} or
@@ -277,23 +271,23 @@ function _isGlobalViewport(viewport) {
  */
 function _normalizeGeometry(geometry) {
   const WORLD = [-180, -90, +180, +90];
-  const worldClip = _clean(bboxClip__default["default"](geometry, WORLD).geometry);
+  const worldClip = _clean(bboxClip(geometry, WORLD).geometry);
   const geometryTxWest = _tx(geometry, 360);
   const geometryTxEast = _tx(geometry, -360);
   let result = worldClip;
   if (result && geometryTxWest) {
-    const worldWestClip = _clean(bboxClip__default["default"](geometryTxWest, WORLD).geometry);
+    const worldWestClip = _clean(bboxClip(geometryTxWest, WORLD).geometry);
     if (worldWestClip) {
       const collection = helpers.featureCollection([helpers.feature(result), helpers.feature(worldWestClip)]);
-      const merged = union__default["default"](collection);
+      const merged = union(collection);
       result = merged ? _clean(merged.geometry) : result;
     }
   }
   if (result && geometryTxEast) {
-    const worldEastClip = _clean(bboxClip__default["default"](geometryTxEast, WORLD).geometry);
+    const worldEastClip = _clean(bboxClip(geometryTxEast, WORLD).geometry);
     if (worldEastClip) {
       const collection = helpers.featureCollection([helpers.feature(result), helpers.feature(worldEastClip)]);
-      const merged = union__default["default"](collection);
+      const merged = union(collection);
       result = merged ? _clean(merged.geometry) : result;
     }
   }
@@ -486,6 +480,8 @@ function formatErrorKey(key) {
 }
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 const requestWithParameters = function (_ref) {
   let {
     baseUrl,
@@ -617,6 +613,8 @@ function excludeURLParameters(baseUrlString, parameters) {
 }
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 const baseSource = function (endpoint, options, urlParameters) {
   try {
     const {
@@ -712,6 +710,8 @@ const SOURCE_DEFAULTS = {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 const boundaryQuerySource = function (options) {
   try {
     const {
@@ -741,6 +741,8 @@ const boundaryQuerySource = function (options) {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 const boundaryTableSource = function (options) {
   try {
     const {
@@ -893,41 +895,43 @@ function executeModel(props) {
     data,
     filters,
     filtersLogicalOperator = 'and',
-    geoColumn = DEFAULT_GEO_COLUMN
+    spatialDataType = 'geo',
+    spatialFiltersMode = 'intersects',
+    spatialFiltersResolution = 0
   } = source;
-  const queryParameters = source.queryParameters ? JSON.stringify(source.queryParameters) : '';
   const queryParams = {
     type,
     client: clientId,
     source: data,
-    params: JSON.stringify(params),
-    queryParameters,
-    filters: JSON.stringify(filters),
+    params,
+    queryParameters: source.queryParameters || '',
+    filters,
     filtersLogicalOperator
   };
+  const spatialDataColumn = source.spatialDataColumn || DEFAULT_GEO_COLUMN;
   // Picking Model API requires 'spatialDataColumn'.
   if (model === 'pick') {
-    queryParams.spatialDataColumn = geoColumn;
+    queryParams.spatialDataColumn = spatialDataColumn;
   }
-  // API supports multiple filters, we apply it only to geoColumn
+  // API supports multiple filters, we apply it only to spatialDataColumn
   const spatialFilters = source.spatialFilter ? {
-    [geoColumn]: source.spatialFilter
+    [spatialDataColumn]: source.spatialFilter
   } : undefined;
   if (spatialFilters) {
-    queryParams.spatialFilters = JSON.stringify(spatialFilters);
+    queryParams.spatialFilters = spatialFilters;
+    queryParams.spatialDataColumn = spatialDataColumn;
+    queryParams.spatialDataType = spatialDataType;
   }
-  const urlWithSearchParams = url + '?' + new URLSearchParams(queryParams).toString();
+  if (spatialDataType !== 'geo') {
+    if (spatialFiltersResolution > 0) {
+      queryParams.spatialFiltersResolution = spatialFiltersResolution;
+    }
+    queryParams.spatialFiltersMode = spatialFiltersMode;
+  }
+  const urlWithSearchParams = url + '?' + objectToURLSearchParams(queryParams).toString();
   const isGet = urlWithSearchParams.length <= REQUEST_GET_MAX_URL_LENGTH;
   if (isGet) {
     url = urlWithSearchParams;
-  } else {
-    // undo the JSON.stringify, @TODO find a better pattern
-    queryParams.params = params;
-    queryParams.filters = filters;
-    queryParams.queryParameters = source.queryParameters;
-    if (spatialFilters) {
-      queryParams.spatialFilters = spatialFilters;
-    }
   }
   return makeCall({
     url,
@@ -941,6 +945,63 @@ function executeModel(props) {
     }
   });
 }
+function objectToURLSearchParams(object) {
+  const params = new URLSearchParams();
+  for (const key in object) {
+    if (isPureObject(object[key])) {
+      params.append(key, JSON.stringify(object[key]));
+    } else if (Array.isArray(object[key])) {
+      params.append(key, JSON.stringify(object[key]));
+    } else if (object[key] === null) {
+      params.append(key, 'null');
+    } else if (object[key] !== undefined) {
+      params.append(key, String(object[key]));
+    }
+  }
+  return params;
+}
+
+const DEFAULT_TILE_SIZE = 512;
+const QUADBIN_ZOOM_MAX_OFFSET = 4;
+function getSpatialFiltersResolution(source, viewState) {
+  const dataResolution = source.dataResolution ?? Number.MAX_VALUE;
+  const aggregationResLevel = source.aggregationResLevel ?? (source.spatialDataType === 'h3' ? DEFAULT_AGGREGATION_RES_LEVEL_H3 : DEFAULT_AGGREGATION_RES_LEVEL_QUADBIN);
+  const aggregationResLevelOffset = Math.max(0, Math.floor(aggregationResLevel));
+  const currentZoomInt = Math.ceil(viewState.zoom);
+  if (source.spatialDataType === 'h3') {
+    const tileSize = DEFAULT_TILE_SIZE;
+    const maxResolutionForZoom = maxH3SpatialFiltersResolutions.find(_ref => {
+      let [zoom] = _ref;
+      return zoom === currentZoomInt;
+    })?.[1] ?? Math.max(0, currentZoomInt - 3);
+    const maxSpatialFiltersResolution = maxResolutionForZoom ? Math.min(dataResolution, maxResolutionForZoom) : dataResolution;
+    const hexagonResolution = getHexagonResolution(viewState, tileSize) + aggregationResLevelOffset;
+    return Math.min(hexagonResolution, maxSpatialFiltersResolution);
+  }
+  if (source.spatialDataType === 'quadbin') {
+    const maxResolutionForZoom = currentZoomInt + QUADBIN_ZOOM_MAX_OFFSET;
+    const maxSpatialFiltersResolution = Math.min(dataResolution, maxResolutionForZoom);
+    const quadsResolution = Math.floor(viewState.zoom) + aggregationResLevelOffset;
+    return Math.min(quadsResolution, maxSpatialFiltersResolution);
+  }
+  return undefined;
+}
+const maxH3SpatialFiltersResolutions = [[20, 14], [19, 13], [18, 12], [17, 11], [16, 10], [15, 9], [14, 8], [13, 7], [12, 7], [11, 7], [10, 6], [9, 6], [8, 5], [7, 4], [6, 4], [5, 3], [4, 2], [3, 1], [2, 1], [1, 0]];
+// stolen from https://github.com/visgl/deck.gl/blob/master/modules/carto/src/layers/h3-tileset-2d.ts
+// Relative scale factor (0 = no biasing, 2 = a few hexagons cover view)
+const BIAS = 2;
+// Resolution conversion function. Takes a WebMercatorViewport and returns
+// a H3 resolution such that the screen space size of the hexagons is
+// similar
+function getHexagonResolution(viewport, tileSize) {
+  // Difference in given tile size compared to deck's internal 512px tile size,
+  // expressed as an offset to the viewport zoom.
+  const zoomOffset = Math.log2(tileSize / DEFAULT_TILE_SIZE);
+  const hexagonScaleFactor = 2 / 3 * (viewport.zoom - zoomOffset);
+  const latitudeScaleFactor = Math.log(1 / Math.cos(Math.PI * viewport.latitude / 180));
+  // Clip and bias
+  return Math.max(0, Math.floor(hexagonScaleFactor + latitudeScaleFactor - BIAS));
+}
 
 /**
  * Source for Widget API requests on a data source defined by a SQL query.
@@ -965,9 +1026,21 @@ class WidgetBaseSource {
       connectionName: props.connectionName,
       filters: getApplicableFilters(owner, props.filters),
       filtersLogicalOperator: props.filtersLogicalOperator,
-      geoColumn: props.geoColumn
+      spatialDataType: props.spatialDataType,
+      spatialDataColumn: props.spatialDataColumn,
+      dataResolution: props.dataResolution
     };
   }
+  _getSpatialFiltersResolution(source, spatialFilter, referenceViewState) {
+    // spatialFiltersResolution applies only to spatial index sources.
+    if (!spatialFilter || source.spatialDataType === 'geo') {
+      return;
+    }
+    if (!referenceViewState) {
+      throw new Error('Missing required option, "spatialIndexReferenceViewState".');
+    }
+    return getSpatialFiltersResolution(source, referenceViewState);
+  }
   /****************************************************************************
    * CATEGORIES
    */
@@ -981,6 +1054,8 @@ class WidgetBaseSource {
       const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController,
         ...params
       } = options;
@@ -989,10 +1064,14 @@ class WidgetBaseSource {
         operation,
         operationColumn
       } = params;
+      const source = _this.getModelSource(filterOwner);
+      const spatialFiltersResolution = _this._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
       return Promise.resolve(executeModel({
         model: 'category',
         source: {
-          ..._this.getModelSource(filterOwner),
+          ...source,
+          spatialFiltersResolution,
+          spatialFiltersMode,
           spatialFilter
         },
         params: {
@@ -1025,6 +1104,8 @@ class WidgetBaseSource {
       const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController,
         ...params
       } = options;
@@ -1036,10 +1117,14 @@ class WidgetBaseSource {
         limit,
         tileResolution
       } = params;
+      const source = _this2.getModelSource(filterOwner);
+      const spatialFiltersResolution = _this2._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
       return Promise.resolve(executeModel({
         model: 'pick',
         source: {
-          ..._this2.getModelSource(filterOwner),
+          ...source,
+          spatialFiltersResolution,
+          spatialFiltersMode,
           spatialFilter
         },
         params: {
@@ -1079,6 +1164,8 @@ class WidgetBaseSource {
       const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController,
         operationExp,
         ...params
@@ -1087,10 +1174,14 @@ class WidgetBaseSource {
         column,
         operation
       } = params;
+      const source = _this3.getModelSource(filterOwner);
+      const spatialFiltersResolution = _this3._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
       return Promise.resolve(executeModel({
         model: 'formula',
         source: {
-          ..._this3.getModelSource(filterOwner),
+          ...source,
+          spatialFiltersResolution,
+          spatialFiltersMode,
           spatialFilter
         },
         params: {
@@ -1119,6 +1210,8 @@ class WidgetBaseSource {
       const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController,
         ...params
       } = options;
@@ -1127,10 +1220,14 @@ class WidgetBaseSource {
         operation,
         ticks
       } = params;
+      const source = _this4.getModelSource(filterOwner);
+      const spatialFiltersResolution = _this4._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
       return Promise.resolve(executeModel({
         model: 'histogram',
         source: {
-          ..._this4.getModelSource(filterOwner),
+          ...source,
+          spatialFiltersResolution,
+          spatialFiltersMode,
           spatialFilter
         },
         params: {
@@ -1175,16 +1272,22 @@ class WidgetBaseSource {
       const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController,
         ...params
       } = options;
       const {
         column
       } = params;
+      const source = _this5.getModelSource(filterOwner);
+      const spatialFiltersResolution = _this5._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
       return Promise.resolve(executeModel({
         model: 'range',
         source: {
-          ..._this5.getModelSource(filterOwner),
+          ...source,
+          spatialFiltersResolution,
+          spatialFiltersMode,
           spatialFilter
         },
         params: {
@@ -1211,6 +1314,8 @@ class WidgetBaseSource {
       const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController,
         ...params
       } = options;
@@ -1220,12 +1325,16 @@ class WidgetBaseSource {
         yAxisColumn,
         yAxisJoinOperation
       } = params;
+      const source = _this6.getModelSource(filterOwner);
+      const spatialFiltersResolution = _this6._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
       // Make sure this is sync with the same constant in cloud-native/maps-api
       const HARD_LIMIT = 500;
       return Promise.resolve(executeModel({
         model: 'scatterplot',
         source: {
-          ..._this6.getModelSource(filterOwner),
+          ...source,
+          spatialFiltersResolution,
+          spatialFiltersMode,
           spatialFilter
         },
         params: {
@@ -1262,6 +1371,8 @@ class WidgetBaseSource {
       const {
         filterOwner,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         abortController,
         ...params
       } = options;
@@ -1272,10 +1383,14 @@ class WidgetBaseSource {
         offset = 0,
         limit = 10
       } = params;
+      const source = _this7.getModelSource(filterOwner);
+      const spatialFiltersResolution = _this7._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
       return Promise.resolve(executeModel({
         model: 'table',
         source: {
-          ..._this7.getModelSource(filterOwner),
+          ...source,
+          spatialFiltersResolution,
+          spatialFiltersMode,
           spatialFilter
         },
         params: {
@@ -1311,6 +1426,8 @@ class WidgetBaseSource {
         filterOwner,
         abortController,
         spatialFilter,
+        spatialFiltersMode,
+        spatialIndexReferenceViewState,
         ...params
       } = options;
       const {
@@ -1324,10 +1441,14 @@ class WidgetBaseSource {
         splitByCategoryLimit,
         splitByCategoryValues
       } = params;
+      const source = _this8.getModelSource(filterOwner);
+      const spatialFiltersResolution = _this8._getSpatialFiltersResolution(source, spatialFilter, spatialIndexReferenceViewState);
       return Promise.resolve(executeModel({
         model: 'timeseries',
         source: {
-          ..._this8.getModelSource(filterOwner),
+          ...source,
+          spatialFiltersResolution,
+          spatialFiltersMode,
           spatialFilter
         },
         params: {
@@ -1358,8 +1479,7 @@ WidgetBaseSource.defaultProps = {
   apiBaseUrl: DEFAULT_API_BASE_URL,
   clientId: getClient(),
   filters: {},
-  filtersLogicalOperator: 'and',
-  geoColumn: DEFAULT_GEO_COLUMN
+  filtersLogicalOperator: 'and'
 };
 
 /**
@@ -1428,6 +1548,9 @@ class WidgetTableSource extends WidgetBaseSource {
 }
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/* eslint-disable camelcase */
 const h3QuerySource = function (options) {
   try {
     const {
@@ -1438,10 +1561,11 @@ const h3QuerySource = function (options) {
       queryParameters,
       filters
     } = options;
+    const spatialDataType = 'h3';
     const urlParameters = {
       aggregationExp,
       spatialDataColumn,
-      spatialDataType: 'h3',
+      spatialDataType,
       q: sqlQuery
     };
     if (aggregationResLevel) {
@@ -1455,7 +1579,12 @@ const h3QuerySource = function (options) {
     }
     return Promise.resolve(baseSource('query', options, urlParameters).then(result => ({
       ...result,
-      widgetSource: new WidgetQuerySource(options)
+      widgetSource: new WidgetQuerySource({
+        ...options,
+        // NOTE: Parameters with default values above must be explicitly passed here.
+        spatialDataColumn,
+        spatialDataType
+      })
     })));
   } catch (e) {
     return Promise.reject(e);
@@ -1463,6 +1592,9 @@ const h3QuerySource = function (options) {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/* eslint-disable camelcase */
 const h3TableSource = function (options) {
   try {
     const {
@@ -1472,11 +1604,12 @@ const h3TableSource = function (options) {
       tableName,
       filters
     } = options;
+    const spatialDataType = 'h3';
     const urlParameters = {
       aggregationExp,
       name: tableName,
       spatialDataColumn,
-      spatialDataType: 'h3'
+      spatialDataType
     };
     if (aggregationResLevel) {
       urlParameters.aggregationResLevel = String(aggregationResLevel);
@@ -1486,7 +1619,12 @@ const h3TableSource = function (options) {
     }
     return Promise.resolve(baseSource('table', options, urlParameters).then(result => ({
       ...result,
-      widgetSource: new WidgetTableSource(options)
+      widgetSource: new WidgetTableSource({
+        ...options,
+        // NOTE: Parameters with default values above must be explicitly passed here.
+        spatialDataColumn,
+        spatialDataType
+      })
     })));
   } catch (e) {
     return Promise.reject(e);
@@ -1494,6 +1632,8 @@ const h3TableSource = function (options) {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 const h3TilesetSource = function (options) {
   try {
     const {
@@ -1509,6 +1649,8 @@ const h3TilesetSource = function (options) {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 const rasterSource = function (options) {
   try {
     const {
@@ -1528,6 +1670,9 @@ const rasterSource = function (options) {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/* eslint-disable camelcase */
 const quadbinQuerySource = function (options) {
   try {
     const {
@@ -1538,11 +1683,12 @@ const quadbinQuerySource = function (options) {
       queryParameters,
       filters
     } = options;
+    const spatialDataType = 'quadbin';
     const urlParameters = {
       aggregationExp,
       q: sqlQuery,
       spatialDataColumn,
-      spatialDataType: 'quadbin'
+      spatialDataType
     };
     if (aggregationResLevel) {
       urlParameters.aggregationResLevel = String(aggregationResLevel);
@@ -1555,7 +1701,12 @@ const quadbinQuerySource = function (options) {
     }
     return Promise.resolve(baseSource('query', options, urlParameters).then(result => ({
       ...result,
-      widgetSource: new WidgetQuerySource(options)
+      widgetSource: new WidgetQuerySource({
+        ...options,
+        // NOTE: Parameters with default values above must be explicitly passed here.
+        spatialDataColumn,
+        spatialDataType
+      })
     })));
   } catch (e) {
     return Promise.reject(e);
@@ -1563,6 +1714,9 @@ const quadbinQuerySource = function (options) {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/* eslint-disable camelcase */
 const quadbinTableSource = function (options) {
   try {
     const {
@@ -1572,11 +1726,12 @@ const quadbinTableSource = function (options) {
       tableName,
       filters
     } = options;
+    const spatialDataType = 'quadbin';
     const urlParameters = {
       aggregationExp,
       name: tableName,
       spatialDataColumn,
-      spatialDataType: 'quadbin'
+      spatialDataType
     };
     if (aggregationResLevel) {
       urlParameters.aggregationResLevel = String(aggregationResLevel);
@@ -1586,7 +1741,12 @@ const quadbinTableSource = function (options) {
     }
     return Promise.resolve(baseSource('table', options, urlParameters).then(result => ({
       ...result,
-      widgetSource: new WidgetTableSource(options)
+      widgetSource: new WidgetTableSource({
+        ...options,
+        // NOTE: Parameters with default values above must be explicitly passed here.
+        spatialDataColumn,
+        spatialDataType
+      })
     })));
   } catch (e) {
     return Promise.reject(e);
@@ -1594,6 +1754,8 @@ const quadbinTableSource = function (options) {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 const quadbinTilesetSource = function (options) {
   try {
     const {
@@ -1609,6 +1771,9 @@ const quadbinTilesetSource = function (options) {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/* eslint-disable camelcase */
 const vectorQuerySource = function (options) {
   try {
     const {
@@ -1620,9 +1785,10 @@ const vectorQuerySource = function (options) {
       queryParameters,
       aggregationExp
     } = options;
+    const spatialDataType = 'geo';
     const urlParameters = {
       spatialDataColumn,
-      spatialDataType: 'geo',
+      spatialDataType,
       tileResolution: tileResolution.toString(),
       q: sqlQuery
     };
@@ -1640,7 +1806,13 @@ const vectorQuerySource = function (options) {
     }
     return Promise.resolve(baseSource('query', options, urlParameters).then(result => ({
       ...result,
-      widgetSource: new WidgetQuerySource(options)
+      widgetSource: new WidgetQuerySource({
+        ...options,
+        // NOTE: Parameters with default values above must be explicitly passed here.
+        spatialDataColumn,
+        spatialDataType,
+        tileResolution
+      })
     })));
   } catch (e) {
     return Promise.reject(e);
@@ -1648,6 +1820,9 @@ const vectorQuerySource = function (options) {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/* eslint-disable camelcase */
 const vectorTableSource = function (options) {
   try {
     const {
@@ -1658,10 +1833,11 @@ const vectorTableSource = function (options) {
       tileResolution = DEFAULT_TILE_RESOLUTION,
       aggregationExp
     } = options;
+    const spatialDataType = 'geo';
     const urlParameters = {
       name: tableName,
       spatialDataColumn,
-      spatialDataType: 'geo',
+      spatialDataType,
       tileResolution: tileResolution.toString()
     };
     if (columns) {
@@ -1675,7 +1851,13 @@ const vectorTableSource = function (options) {
     }
     return Promise.resolve(baseSource('table', options, urlParameters).then(result => ({
       ...result,
-      widgetSource: new WidgetTableSource(options)
+      widgetSource: new WidgetTableSource({
+        ...options,
+        // NOTE: Parameters with default values above must be explicitly passed here.
+        spatialDataColumn,
+        spatialDataType,
+        tileResolution
+      })
     })));
   } catch (e) {
     return Promise.reject(e);
@@ -1683,6 +1865,8 @@ const vectorTableSource = function (options) {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 const vectorTilesetSource = function (options) {
   try {
     const {
@@ -1698,6 +1882,8 @@ const vectorTilesetSource = function (options) {
 };
 
 // deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 const query = function (options) {
   try {
     const {