@carto/api-client 0.5.27 → 0.5.29

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # CHANGELOG
 
+## Unreleased
+
+### 0.5.29
+
+- feat(sources): Support featureBbox parameter (#289)
+
+### 0.5.28
+
+- feat(fetchMap): Support zoom-dependent point styling (#287)
+- feat(fetchMap): Support autoLabels (#288)
+
 ### 0.5.27
 
 - feat(parseMap): custom aggregation support on spatial-index and geometry-aggregated layers. Adds `compileCustomAggregation(expression, { provider })` helper, `VisualChannelField.accessorKey`, and `{channel}AggregationExp` / `{channel}AggregationDomain` on `VisConfig` for all 6 channels.

package/build/api-client.cjs

@@ -8564,7 +8564,8 @@ var vectorQuerySource = async function(options) {
     sqlQuery,
     tileResolution = DEFAULT_TILE_RESOLUTION,
     queryParameters,
-    aggregationExp
+    aggregationExp,
+    featureBbox
   } = options;
   const spatialDataType = "geo";
   const urlParameters = {
@@ -8585,6 +8586,9 @@ var vectorQuerySource = async function(options) {
   if (aggregationExp) {
     urlParameters.aggregationExp = aggregationExp;
   }
+  if (featureBbox) {
+    urlParameters.featureBbox = true;
+  }
   return baseSource("query", options, urlParameters).then(
     (result) => ({
       ...result,
@@ -8608,7 +8612,8 @@ var vectorTableSource = async function(options) {
     spatialDataColumn = DEFAULT_GEO_COLUMN,
     tableName,
     tileResolution = DEFAULT_TILE_RESOLUTION,
-    aggregationExp
+    aggregationExp,
+    featureBbox
   } = options;
   const spatialDataType = "geo";
   const urlParameters = {
@@ -8626,6 +8631,9 @@ var vectorTableSource = async function(options) {
   if (aggregationExp) {
     urlParameters.aggregationExp = aggregationExp;
   }
+  if (featureBbox) {
+    urlParameters.featureBbox = true;
+  }
   return baseSource("table", options, urlParameters).then(
     (result) => ({
       ...result,
@@ -10047,10 +10055,11 @@ function getIconUrlAccessor(field, range, {
   return normalizeAccessor(accessor, data);
 }
 function getMaxMarkerSize(visConfig, visualChannels) {
-  const { radiusRange, radius } = visConfig;
+  const { radiusRange, radius, sizeMaxPixels } = visConfig;
   const { radiusField, sizeField } = visualChannels;
   const field = radiusField || sizeField;
-  return Math.ceil(radiusRange && field ? radiusRange[1] : radius);
+  const baseSize = radiusRange && field ? radiusRange[1] : radius;
+  return Math.ceil(sizeMaxPixels ?? baseSize);
 }
 function negateAccessor(accessor) {
   if (typeof accessor === "function") {
@@ -10565,6 +10574,7 @@ function getLayerDescriptor({
       ...createInteractionProps(interactionConfig),
       ...styleProps,
       ...channelProps,
+      ...createZoomScaleProps(config2, visualChannels),
       ...createParametersProp(layerBlending, styleProps.parameters || {}),
       // Must come after style
       ...createLoadOptions(data.accessToken)
@@ -10634,6 +10644,28 @@ function createInteractionProps(interactionConfig) {
     pickable
   };
 }
+function createZoomScaleProps(config2, visualChannels) {
+  const { visConfig } = config2;
+  if (!visConfig.radiusScaleWithZoom || visualChannels.radiusField || visualChannels.sizeField) {
+    return {};
+  }
+  const scale2 = Math.pow(2, -visConfig.radiusReferenceZoom);
+  const result = {
+    pointRadiusUnits: "common",
+    pointRadiusScale: scale2,
+    iconSizeUnits: "common",
+    iconSizeScale: scale2
+  };
+  if (visConfig.sizeMinPixels !== void 0) {
+    result.pointRadiusMinPixels = visConfig.sizeMinPixels;
+    result.iconSizeMinPixels = visConfig.sizeMinPixels;
+  }
+  if (visConfig.sizeMaxPixels !== void 0) {
+    result.pointRadiusMaxPixels = visConfig.sizeMaxPixels;
+    result.iconSizeMaxPixels = visConfig.sizeMaxPixels;
+  }
+  return result;
+}
 function mapProps(source, target, mapping) {
   for (const sourceKey in mapping) {
     const sourceValue = source[sourceKey];
@@ -11023,7 +11055,15 @@ function createChannelProps(id, layerType, config2, visualChannels, data, datase
     } = secondaryLabel || {};
     result.getText = mainLabel.field && getTextAccessor(mainLabel.field, data);
     const getSecondaryText = secondaryField && getTextAccessor(secondaryField, data);
-    result.pointType = `${result.pointType}+text`;
+    const geometry = data.tilestats?.layers?.[0]?.geometry;
+    const isLineOrPolygon = geometry === "Polygon" || geometry === "MultiPolygon" || geometry === "Line" || geometry === "LineString" || geometry === "MultiLineString";
+    if (isLineOrPolygon && (layerType === "tileset" || layerType === "mvt")) {
+      const uniqueIdProperty = visConfig.textLabelUniqueIdField;
+      result.autoLabels = uniqueIdProperty ? { uniqueIdProperty } : true;
+      result.pointType = "text";
+    } else {
+      result.pointType = `${result.pointType}+text`;
+    }
     result.textCharacterSet = "auto";
     result.textFontFamily = "Inter, sans";
     result.textFontSettings = { sdf: true };
@@ -11184,11 +11224,13 @@ function configureSource({
     tileResolution,
     ...queryParameters && { queryParameters }
   };
+  const { featureBbox } = dataset;
   const vectorOptions = {
     spatialDataColumn,
     ...columns && { columns },
     ...filters && { filters },
-    ...aggregationExp && { aggregationExp }
+    ...aggregationExp && { aggregationExp },
+    ...featureBbox && { featureBbox }
   };
   if (type === "raster") {
     return rasterSource({
@@ -11472,6 +11514,21 @@ async function fetchMap({
       }
     }
   });
+  const layers = map.keplerMapConfig.config.visState.layers;
+  const datasetsWithLabels = /* @__PURE__ */ new Set();
+  for (const layer of layers) {
+    const hasTextLabel = layer.config?.textLabel?.some(
+      (t) => t.field?.name
+    );
+    if (hasTextLabel) {
+      datasetsWithLabels.add(layer.config.dataId);
+    }
+  }
+  map.datasets.forEach((dataset) => {
+    if (datasetsWithLabels.has(dataset.id) && (dataset.type === "table" || dataset.type === "query")) {
+      dataset.featureBbox = true;
+    }
+  });
   const [basemap] = await Promise.all([
     fetchBasemapProps({ config: map.keplerMapConfig.config, errorContext }),
     // Mutates map.datasets so that dataset.data contains data