Release Notes

These release notes are specific to CARTO for Developers and should be read as a complement to:

• The official CARTO what's new

• The official deck.gl changelog

June 16th, 2025

@carto/api-client 0.5.8

View in Github

• Custom aggregation for getCategories and getTimeSeries models: You can now specify custom SQL aggregation (operationExp) in your categories and time series models.

• Automatic aggregation as "others" in getCategories: Specifiy othersThreshold in your getCategories model and CARTO will automatically aggregate the values for any additional categories as _carto_others

May 20th, 2025

@carto/api-client 0.5.5

View in Github

• Extended support for fetchMap: Developers can use fetchMap directly from carto/api-client to integrate layers and interactions from Builder maps in their applications.

March 27th, 2025

@carto/api-client 0.5.0

View in Github

• Widgets for Tileset and Raster sources: Developers using CARTO can now create custom, scalable charts and widgets on top of tilesets and raster sources, powered by GPU, client-side calculations.

Jan 12th, 2025

@carto/api-client 0.4.4

View in Github

• Data sources are now part of @carto/api-client

@deck.gl 9.1

What's new | Upgrade guide

• deck.gl continues its roadmap towards WebGPU-readiness, among other features you can discover in the deck.gl what's new.

• Changes in the @deck.gl/CARTO module:

  • @carto/api-client is now a dependency, starting with 0.4.4

  • Starting in deck.gl 9.1, you should import your data sources directly from @carto/api-client

Jan 7th, 2025

@carto/api-client 0.4.0

View in Github

• Widgets for Spatial-index sources: Developers using CARTO can now create custom, scalable widgets on top of their spatial index data sources, in the Javascript framework of their choice. Learn more in our what's new announcement.

October 9th, 2024

@carto/api-client 0.3.1

View in Github

• New framework-agnostic widgets in CARTO: Build completely custom charts and widgets on top of your CARTO vector-based sources using the framework of your choice, fully powered by your data warehouse. Accelerate your development times, even for large scale data. Learn more in the CARTO what's new.

• New filter constructors for CARTO widgets and sources: Seamlessly add interactivity and filter the charts and layers in your app with our new Filter constructors, for both column-based and spatial-based filtering.

March 27th, 2024

@deck.gl 9.0

What's new | Upgrade guide

• New CARTO module architecture:

  • The CartoLayer has been replaced by Sources and Layers, that provide more flexibility and readability.

  • The setDefaultCredentials function has been removed. Authentication must be passed to the Source, providing more flexibility for a single codebase.

  • The fetchLayerData function has been replaced by the new query function, which provides a simpler interface to request data to the CARTO SQL API. This data can then be used in other deck.gl layers.

March 9th, 2023

@deck.gl 8.9 What's new | Upgrade guide

June 30th, 2022

@deck.gl 8.8 What's new | Upgrade guide

• The CartoLayer now works only with dynamic tiles. The format property has been removed. If you want to keep using GeoJSON instead of tiles, you need to use the fetchLayerData function.

• Dynamic tiles support for SQL queries.

• Support for dynamic and static tilesets with data aggregated using H3 and Quadbin discrete global grids. New aggregationExp and aggregationResLevel props in CartoLayer.

February 25th, 2022

@deck.gl 8.7

• New fetchMap function for loading a Builder map.

• New MaskExtension to apply a spatial mask to layers.

• Support for dynamic tiling with MAP_TYPES.TABLE data sources.

• New QuadkeyLayer supporting visualization of data using the Quadkey spatial indexing scheme.

• Changes in configuration defaults: apiBaseUrl now defaults to https://gcp-us-east1.api.carto.com and apiVersion to API_VERSIONS.V3. If you have code using a CARTO 2 dataset and you have not specified the apiVersion property, your code needs to be updated in order to work with the new version.

• New format and formatTiles props in CartoLayer.

October 12th, 2021

@deck.gl 8.6

• Default to binary mode in MVTLayer.

• Include API error at the exception message.

• New geoColumn and columns props in CartoLayer.

• Fix MVTLayer autoHighlight with binary data.

• Check for correct layerName when highlighting in MVTLayer.

In addition to these changes to the CARTO for deck.gl module and the MVTLayer, we have also implemented support for the new Google Maps vector rendering features in the Google Maps module.

July 26th, 2021

@deck.gl 8.5

• CARTO 3 integration.

• New CartoLayer supporting all the Maps API versions (CartoSQLLayer and CartoBQTiler layers will be deprecated and we recommend migrating existing code).

• Support triangulation of polygons for MVTLoader in loaders.gl.

• Support pointType prop to allow changing point rendering in GeoJsonLayer.

February 1st, 2021

@deck.gl 8.4

• Basemap module for @deck.gl/carto.

• Style helpers and CARTO colors.

• Support for CARTO Maps API v2.

• Add onDataLoad and onDataError callbacks to CARTO layers.

• TileJSON support to the MVTLayer.

• MVTLayer getRenderedFeatures.

• MVTLayer coordinates transformation to WGS84.

• MVTLayer binary data support.

October 12th, 2020

@deck.gl 8.3

• Add @deck.gl/carto module (CartoSqlLayer and CartoBQTilerLayer).

• MVTLayer: support globe view.

June 28th, 2020

@deck.gl 8.2

• Fix MVTLayer projection precision.

• FillStyleExtension supports MVTLayer.

March 17th, 2020

@deck.gl 8.1

• New MVTLayer for working with vector tiles.