On-Prem Map SDK releases contain updates to both:

- 🛠️ **API** of the SDK, for developers
- 🖥️ **Features** of the application and its interface

> Some features are exclusively available in the public Map SDK. To compare the On-Prem and public versions of the Map SDK, please refer to the [feature matrix](https://docs.foursquare.com/developer/docs/studio-map-sdk-on-prem-feature-matrix).

* * *

# 1.13.0
Released December 5th, 2023

### 🛠️ API  
- **New**: [Annotations](https://docs.foursquare.com/developer/docs/studio-map-sdk-annotation-functions) APIs have been added that allow for programmatically adding text and callouts to the map. [Run an example in your browser](https://docs.foursquare.com/developer/docs/studio-map-sdk-example-annotations).
- **New**: [Effects](https://docs.foursquare.com/developer/docs/studio-effect-configuration) API has been added to control post-processing effects programmatically. [Run an example in your browser](https://docs.foursquare.com/developer/docs/studio-map-sdk-example-effects).
- **New**: Add layers from their JSON configurations with [addLayerFromConfig](https://docs.foursquare.com/developer/docs/studio-map-sdk-layer-functions#add-layer-from-config). Provides improved typing over [addLayer()](https://docs.foursquare.com/developer/docs/studio-map-sdk-layer-functions#add-layer), and can work with JSON layer editor directly.
- **New**: You may now control the view (`2d`, `3d`, or `globe`) with [getViewMode](https://docs.foursquare.com/developer/docs/studio-map-sdk-map-functions#get-view-mode) and [setViewMode](https://docs.foursquare.com/developer/docs/studio-map-sdk-map-functions#set-view-mode).
- **New**: Shadow DOM is now used for rendering, providing much better mutual isolation of styles between Map SDK and the rest of the page; also helping resolve multiple visual bugs.
- Improved: [`setView`](https://docs.foursquare.com/developer/docs/studio-map-sdk-map-functions#set-view) can now enable/disable drag rotation.
- Improved: Added `columnMode` to the [LayerConfig](https://docs.foursquare.com/developer/docs/studio-map-sdk-types#layerconfig) type.
- Fixed: A number of bugs has been addressed across several versions. The full list can be found in the public [Map SDK's release notes](https://docs.foursquare.com/developer/docs/studio-map-sdk-changelog).

### 🖥️ Features  
Includes updates from Studio [v1.65](https://docs.foursquare.com/studio/docs/release-notes#version-165) through [1.74](https://docs.foursquare.com/studio/docs/release-notes#version-174).
- **New**: [Post-Processing Effects](https://docs.foursquare.com/studio/docs/release-notes#post-processing-effects) can be added to bring a unique artistic touch to your maps. This tool goes beyond simple image processing, offering effects such as **Light and Shadow** that accurately simulates sunlight casting over the map, accentuating 3D elements with striking shadows.
- **New**: [Hints](https://docs.foursquare.com/studio/docs/release-notes#charts-hints) can be added to the Line and Bar charts, helping viewers interpret the chart.
- **New**: Several map controls, including a [map scale](https://docs.foursquare.com/studio/docs/release-notes#map-scale), [zoom controls, and compass](https://docs.foursquare.com/studio/docs/release-notes#zoom-controls).
- **New**: A JSON configuration editor, offering a fully-featured code editor, is now available for both [filters](https://docs.foursquare.com/studio/docs/release-notes#filters-config-editor) and [charts](https://docs.foursquare.com/studio/docs/release-notes#charts-config-editor).
- Improved: The legend can now be [moved and resized](https://docs.foursquare.com/studio/docs/release-notes#legend-move-and-resize).
- Improved: Users may now [reorder tooltip items](https://docs.foursquare.com/studio/docs/release-notes#tooltip-reordering).
- Improved: [Vector Tiles](https://docs.foursquare.com/studio/docs/release-notes#vector-tile-style-improvements) now offer more configuration options, including custom stroke width and color based on data fields, as well as a [dynamic color toggle](https://docs.foursquare.com/studio/docs/release-notes#vector-tiles-dynamic-color), which allows the color scale to change based on data visible in the viewport.
- Improved: Bar chart items can now be [manually sorted](https://docs.foursquare.com/studio/docs/release-notes#bar-chart-manual-sort).
- Improved: Layer groups have been [visually overhauled](https://docs.foursquare.com/studio/docs/release-notes#layer-group-improvements), improving organization for maps with many layers.

* * *

# 1.8.1-3
Released June 30th, 2023

_Maintenance release_

* * *

# 1.8.1-2
Released June 30th, 2023

_Maintenance release_

* * *

# 1.8.1-1
Released June 1st, 2023

### 🛠️ API  
- **New**: Raster Color Legend
  - See `colorLegends` in [this example](https://docs.foursquare.com/developer/docs/studio-layer-reference#raster-tile).
- Improved: Categorical Color Scale
  - Now disables the layer configuration UI and rescaling sliders.
  - This ensures a rescaling of 0-1 (we interpret this as “no rescaling”) on the GPU to preserve the internal mapping of the categorical values to 0-1 values that map the current color palette.

* * *

# 1.8.1
Released May 17th, 2023

### 🛠️ API  
- Improved: Our delivery automation pipeline now includes licenses and static resources in each version.
- Fixes: Bug fixes and performance improvements.

### 🖥️ Features  
Includes updates up to Studio [v1.62](https://docs.foursquare.com/studio/docs/release-notes#version-162).
- **New**: The new [Heatmap Chart](https://docs.foursquare.com/studio/docs/release-notes#heatmap-chart) can be used to observe patterns, dependencies, and associations between different geographic variables or attributes in a dataset. Offering complete customization of the correlation matrix, the Heatmap Chart highlights values atop a vibrant color palette.
- **New**: Raster Tiles now offer a dynamic color scale (UI toggle) for all band types.
- **New**: A loading progress indicator has been added to the lower-left corner.
- Improved: Multiple tiles can now be loaded simultaneously, increasing the performance of maps with several tile sources.

* * *

# 1.8.0
Released May 5th, 2023

### 🛠️ API  
- **New**: On-prem users may now allow data export via [`MapCreationProps`](https://docs.foursquare.com/developer/docs/studio-map-sdk-types#mapcreationprops)

### 🖥️ Features  
Includes updates up to Studio [v1.61](https://docs.foursquare.com/studio/docs/release-notes#version-161).
- **New**: The viewport may now be accessed and modified via [Studio's config editor](https://docs.foursquare.com/studio/docs/release-notes#viewport-configuration-editor). With full control of the viewport configuration, you may now set an exact zoom level, latitude/longitude, and many other settings.
- Improved: [Label text](https://docs.foursquare.com/studio/docs/release-notes#labels-text-outline) can now be outlined with a custom stroke width, stroke color, and background color. Labels are available for configuration in the Point, Polygon, Trip, Icon, and H3 Layer.

* * *

# 1.7.0
Released April 5th, 2023

### 🛠️ API  
- Improved: [replaceDataset](https://docs.foursquare.com/developer/docs/studio-map-sdk-data-functions#replace-dataset) now validates the new dataset for any missing or mismatched columns.
- Improved: [The raster layer](https://docs.foursquare.com/developer/docs/studio-layer-reference#raster-tile) now supports categorical mapping of color values to raster image pixels.

### 🖥️ Features  
Includes updates up to Studio [v1.57](https://docs.foursquare.com/studio/docs/release-notes#version-157) through [v1.60](https://docs.foursquare.com/studio/docs/release-notes#version-160).
- **New**: Modify layers programmatically via Studio's new feature-rich [config editor](https://docs.foursquare.com/studio/docs/release-notes#layer-config-editor). Offers syntax suggestions, multi-line editing, and a number of other options found in modern code editors.
- **New**: Studio now offers support for [WMS services](https://docs.foursquare.com/studio/docs/release-notes#wms-service-support), rendering map imagery as a \[visual layer\]. Instead of downloading a map for the entire globe, an image is rendered covering the current viewport.
- Improved: The Raster Layer now supports [single-band viewing](https://docs.foursquare.com/studio/docs/release-notes#raster-layer-single-band-support).

* * *

# 1.6.0
Released March 8th, 2023

### 🛠️ API  
- **New**: Added [`RasterTileLoadEvent`](https://docs.foursquare.com/developer/docs/studio-map-sdk-types#rastertileloadevent), a type returning raster tile loading status updates.
- **New**: [`raster.onTileLoadUpdate`](https://docs.foursquare.com/developer/docs/studio-map-sdk-map-functions#arguments) for raster tile requests.

### 🖥️ Features  
Includes updates up to Studio [v1.50](https://docs.foursquare.com/studio/docs/release-notes#version-150) through [v1.56](https://docs.foursquare.com/studio/docs/release-notes#version-156).
- **New**: Aggregate data from columns using a new suite of [aggregation expressions](https://docs.foursquare.com/studio/docs/release-notes#expressions-new-aggregation-functions), including `sum`, `count`, `quantile`, and more. [Big number charts](https://docs.foursquare.com/studio/docs/charts-big-number) support these expressions, letting you compute and display aggregated metrics in a matter of seconds.
- Improved: Our expression editor has been redesigned to expedite column creation. Find our library of built-in functions on the left panel, then view function definitions and expected parameters in the editor window.
- Improved: Several [chart](https://docs.foursquare.com/studio/docs/release-notes#chart-improvements) enhancements have been added, allowing users to set custom labels to the Y axis, toggle grid lines, apply padding between bars and groups, and set [benchmarks](https://docs.foursquare.com/studio/docs/release-notes#charts-benchmark).
- Improved: Editing [annotations](https://docs.foursquare.com/studio/docs/release-notes#annotation-improvements) is now easier with a number of bug fixes and quality-of-life changes. All annotations on a map can now be toggled on or off from the Interactions tab, and the rich text editor now supports vertical alignment.
- Improved: [The H3 layer](https://docs.foursquare.com/studio/docs/release-notes#h3-layer-improvements) now supports text labels, stroke outline customization, and fill transparency.
- Improved: Temporal data can now be [grouped and displayed as multiple lines on the histogram](https://docs.foursquare.com/studio/docs/release-notes#time-series-group-by), providing your audience with a categorical comparison alongside an animated visualization.

* * *

# 1.5.2
Released November 1st, 2022

### 🛠️ API  
- Fix: Databricks HTML rendering issues have been resolved.

* * *

# 1.5.1
Released October 28th, 2022

### 🛠️ API  
- Fix: Minor changes related to Foursquare Studio rebranding.

* * *

# 1.5.0
Released October 25th, 2022

### 🛠️ API  
- **New**: Added the [`onUserEvent` event handler](https://docs.foursquare.com/developer/docs/studio-map-sdk-types#analyticseventhandlers). The listener receives any user-initiated actions, allowing for improved tracking metrics.
- Improved: Added the [`urls` parameter to the Python SDK](https://docs.foursquare.com/developer/docs/studio-map-sdk-api-reference#createmap). Note: this parameter has already existed on the Javascript SDK as part of the [`MapCreationProps`](https://docs.foursquare.com/developer/docs/studio-map-sdk-types#mapcreationprops) object.

* * *

# 1.4.0-1
Released October 18th, 2022

_Maintenance release_

* * *

# 1.4.0
Released October 14th, 2022

### 🛠️ API  
- **New**: Added [`transformRequest`](https://docs.foursquare.com/developer/docs/studio-map-sdk-types#mapcreationprops) for raster tile requests
- Improved: Added urls: [`applicationUrlBase` and `applicationUrlBase`](https://docs.foursquare.com/developer/docs/studio-map-sdk-types#mapcreationprops) properties that allows caller to specify URL where they can host on-prem assets loaded by Studio

* * *

# 1.3.1-1
Released October 6th, 2022

_Maintenance release_

* * *

# 1.3.1
Released October 5th, 2022

### 🛠️ API  
- Fix: Jupyter-related cell synchronization.

* * *

# 1.3.0-1
Released September 30th, 2022

_Maintenance release_

* * *

# 1.3.0
Released September 27th, 2022

### 🛠️ API  
- Improved: Added `mapboxAccessToken` property to [`MapCreationProps.basemaps`](https://docs.foursquare.com/developer/docs/studio-map-sdk-types#mapcreationprops)
  - Default map styles will be replaced by custom map styles.
  - On-prem users must specify a custom map style. If left unspecified, only the No Basemap will be available for basemap selection.
- Improved: Added `mapName` property to [`MapCreationProps.uiConfig`](https://docs.foursquare.com/developer/docs/studio-map-sdk-types#mapcreationprops)
  - Defaults `mapName` = "Studio"

* * *

# 1.2.0
Released September 15th, 2022

### 🛠️ API  
- **New**: [layer groups](https://docs.foursquare.com/developer/docs/studio-map-sdk-layer-functions#add-layer-group), conceptual groups used to organize layers. New endpoints:
  - [addLayerGroup](https://docs.foursquare.com/developer/docs/studio-map-sdk-layer-functions#add-layer-group)
  - [getLayerGroupById](https://docs.foursquare.com/developer/docs/studio-map-sdk-layer-functions#get-layer-group-by-id)
  - [getLayerGroups](https://docs.foursquare.com/developer/docs/studio-map-sdk-layer-functions#get-layer-groups)
  - [removeLayerGroup](https://docs.foursquare.com/developer/docs/studio-map-sdk-layer-functions#remove-layer-group)
  - [updateLayerGroup](https://docs.foursquare.com/developer/docs/studio-map-sdk-layer-functions#update-layer-group)
- **New**: Added customization support for the "Add Data" button (including a custom event handler) as part of [`MapCreationProps.uiConfig`](https://docs.foursquare.com/developer/docs/studio-map-sdk-types#mapcreationprops).
- Improved: `create_map` can now render static HTML maps in Databricks environments.
- Fix: Fixed a minor bug where `replaceDataset` would not function unless both datasets had different ids.

* * *

# 1.1.0
Released September 1st, 2022

### 🛠️ API  
- Improved: Added the `uiConfig` parameter to [MapCreationProps](https://docs.foursquare.com/developer/docs/studio-map-sdk-types#mapcreationprops), allowing customization of the leftmost Studio panel.

* * *

# 1.0.1
Released August 23rd, 2022

### 🛠️ API  
- Fix: Solved an issue when trying to display a map in multiple cells.

* * *

# 1.0.0
Released August 18th, 2022

🎉 Initial Release 🎉