Release of version 2.3.1 (2026-04-28)

What's New

• ROU-12633 - Added a new HeatmapLayer block using deck.gl as the provider.
  This update introduces a high-performance HeatmapLayer, powered by deck.gl, replacing the native Google Maps HeatmapLayer. This ensures continued support and enhanced visualization capabilities ahead of Google's scheduled removal of the legacy library in Maps JavaScript API version 3.65 (May 2026).
• ROU-12638 - Updated Google Maps Drawing Tools to use TerraDraw as the new default provider.
  This update replaces the native Google Maps Drawing Library with TerraDraw to ensure continued functionality following Google's announcement that the legacy library will be removed starting with Maps JavaScript API version 3.65 (May 2026).

Fixed Issues and Improvements

• ROU-12504 / RPM-6440 - Fixed an issue that caused the Map component to experience significant performance lag and unresponsiveness. This occurred when handling large datasets with multiple markers, specifically when the MarkerCluster feature was enabled.

Release of version 2.2.0 (2026-01-27)

Fixed Issues and Improvements

• ROU-11655 - Fixed an issue that caused the LeafletMap to inadvertently scroll the background page when the component was placed in focus.
  This fix ensures that map interactions remain contained within the widget, preventing unexpected page scrolls for the user.
• ROU-12285 / RPM-6181 - Added a new optional configuration called respectUserPosition to both the Map and Leaflet components.
  This allows the map to maintain the user’s current position when calculating the map center, rather than snapping back to a default location.
• Fixed an issue that caused the Map to snap back to the initial center point even after a user had manually moved or zoomed.
  The logic has been updated to prioritize the user's current view if respectUserZoom or respectUserPosition is enabled.
  If those settings are disabled or the map is in its default state, the center will fallback to the developer-defined position, the first marker, or a calculated center of all markers when Zoom Auto is active.

Release of version 2.1.0 (2025-08-04)

What's New

• ROU-12040 - Added support for the new Google Routes API for all client actions related to Directions. This update ensures compatibility, as Google now classifies the older Routes APIs as legacy - read more.
• ROU-12041 - Added a new component named ‘SearchPlaces’, which leverages the latest Google Maps Places API. The existing component was renamed to 'SearchPlaces_Legacy', as Google now classifies the older Places APIs as legacy - read more.

Fixed Issues and Improvements

• ROU-11822 - Improved the component's feedback to indicate that the 'MapStyleId' property cannot be changed after map initialization.
• ROU-12069 / RPM-5988 - Fixed an issue that caused the Markers to throw an error when being destroyed, when the Map was removed first.
  This occurred when the Map was removed and contained Marker blocks.
  The Map would remove all Markers from an internal list to avoid memory leaks (when the marker was created via API). To fix the issue, the Map is now removing only the markers created by the API, leaving the remaining Markers to remove themselves from the internal list.

Release of version 2.0.1 (2025-02-26)

Fixed Issues and Improvements

• ROU-11587/RPM-5553 - Fixed an issue that caused runtime errors when loading Google Search Places due to network latency.
  This issue occurred when using the SearchPlaces component and when attempts to access the Google Places module were made before the library was fully loaded.
• ROU-11589 - Fixed an issue that caused the click event of a marker not to be triggered and the map center to be changed.
  This occurred when the marker used a custom icon and respective sizes on a Leaflet map.
• ROU-11629 - Fixed an issue that caused Google Maps and Search Places components to throw runtime errors on devices with slow connections.
  This occurred when the components were destroyed while the creation logic was still in progress.

Release of version 2.0.0 (2024-12-02)

What's New

• ROU-4763 - Now, GoogleMaps, StaticMap, and SearchPlaces have a new localization setting to allow the selection of the map’s language and region to be displayed to the end user.
  This improvement will cause a soft-breaking change in existing apps by adding a new parameter to the OptionalConfigs structure.
• ROU-4776 - A new site property, GoogleMapsVersion, has been added to the OutSystems Maps module. This property allows you to define which version of Google Maps should be loaded.
  By default, it is set to version 3.58 (the stable release for November 2024).
  If an invalid or unsupported version is specified, Google Maps will automatically default to the latest weekly version.
  Please note, that any updates to this property will require a manual application reload for the changes to take effect.
• ROU-11055 - Support for Google Maps new AdvancedMarkerElement has been added and is now used as the default marker.
  To accommodate this update, a new parameter called UseAdvancedMarkers (default: true) has been introduced in the Google Map optional configurations.
  Additionally, a new parameter was added to the Google Map optional configurations, called MapStyleId.
  This parameter is used to indicate the ID of the map styles created in the Google Cloud Console, and it will only be used when the parameter UseAdvancedMarkers is set to true.
  If the deprecated Google Marker needs to be used for compatibility reasons, set UseAdvancedMarkers to false.
  For more info about this change check this link.
• ROU-11344 - Updated Leaflet library to the latest version 1.9.4.

Fixed Issues and Improvements

• ROU-4864 - Fixed an issue that was causing parameters like Offset or Localization not to be set correctly to the provider configurations when they changed in runtime.

ROU-10685 - Fixed an issue that caused the Leaflet's autofit functionality to be broken.
This occurred when markers were added or deleted from the map in runtime.

• ROU-11371 - Fixed an issue where a Leaflet Map failed to update its center coordinates after panning or zooming. The center coordinates now properly reflect changes when the map is moved or zoomed.

Release of version 1.7.0 (2024-04-01)

What's New

• ROU-3174 - Now, we can use the new Map’s optional configuration AutoZoomOnShapes to allow the auto zoom feature to adjust and fit all shapes displayed on the map.
  This functionality is only applicable to Zoom = Entities.Zoom.Auto.
  For Leaflet Maps, this property cannot be changed in runtime.
• ROU-4665 - A new parameter called RespectUserZoom has been added to the OptionalConfigs structure of the Map and LeafletMap blocks.
  This parameter allows developers to signal whether user zoom changes should be respected when adding, changing, or removing other markers.
• ROU-4708 - Created new client actions called AddMarker / RemoveAllMarkers / RemoveMarker / SubscribeMarkerEvent / UnsubscribeMarkerEvent to create, remove and subscribe/unsubscribe events from Markers.
  These will help deal with a large number of markers for better runtime performance.

Fixed Issues and Improvements

• ROU-4708 - Improved the way a Map is obtained by its widget identifier.
• ROU-4709 - Fixed an issue that caused the OutSystems Maps to write a warning on the console.
  This occurred when we were using marker clusters since google.maps.event.addDomListener() was deprecated.
  The js-markerclusterer library was upgraded to version 2.5.3, changing how clusters are created.
  This causes a breaking change when setting the marker clusters to true and changing the UI of the clusters using CSS.

ODC Release of version 1.6.7 (2024-01-24)

Fixed Issues and Improvements

• ROU-4469 - Deprecated the AdvancedFormat parameter from the structure OptionalStaticMapConfigs, used in the StaticMap block.
  To be compliant with Content Security Policy (CSP) requirements, the usage of the eval() function will be discontinued so, consequently, this parameter will be impacted and may not function as expected.
• ROU-4591 - The mechanism to translate addresses into coordinates was changed. Prior the code was using an external Google REST API, while now, it uses the available method in Google SDK (geo.geocode).
• ROU-4592 - Fixed an issue that caused the wrong popup to open when clicking on a marker.
  This occurred when a custom icon and the size (width and height) were set into a MarkerPopup, especially with many Markers on the screen.

Release of version 1.6.7 (2023-12-26)

Fixed Issues and Improvements

• ROU-4469 - Deprecated the AdvancedFormat parameter from the structure OptionalStaticMapConfigs, used in the StaticMap block.
  To be compliant with Content Security Policy (CSP) requirements, the usage of the eval() function will be discontinued so, consequently, this parameter will be impacted and may not function as expected.
• ROU-4591 - The mechanism to translate addresses into coordinates was changed. Prior the code was using an external Google REST API, while now, it uses the available method in Google SDK (geo.geocode).
• ROU-4592 - Fixed an issue that caused the wrong popup to open when clicking on a marker.
  This occurred when a custom icon and the size (width and height) were set into a MarkerPopup, especially with many Markers on the screen.

ODC Release of version 1.6.6 (2023-07-31)

Fixed Issues and Improvements:

• ROU-4222 - Fixed an issue that caused the Draw Shape AddOns to return the Coordinates and Location parameters empty on the OnDrawingChange event.
  This occurred when a client action was associated with the DrawingTools' OnDrawingChange event and a shape was modified (dragged or resized) after its creation.
• ROU-4283 - Fixed an issue that caused the Draw Markers to not return the right coordinates after an OnDrawingChange event.
  This occurred when the Draw Marker was configured to allow drag and the OnDrawingChange event was configured to return the coordinates.
• ROU-4361 - Now, the Map’s preview images were optimised in order to reduce the module size.
• ROU-4370 - Fixed an issue that caused the Map_Initialized event not to run after the first time a Map was created.
  This occurred when leaving a screen with a Map block (Google Maps) and returning to it afterwards.

Release of version 1.6.6 (2023-12-26)

Fixed Issues and Improvements:

• ROU-4222 - Fixed an issue that caused the Draw Shape AddOns to return the Coordinates and Location parameters empty on the OnDrawingChange event.
  This occurred when a client action was associated with the DrawingTools' OnDrawingChange event and a shape was modified (dragged or resized) after its creation.
• ROU-4283 - Fixed an issue that caused the Draw Markers to not return the right coordinates after an OnDrawingChange event.
  This occurred when the Draw Marker was configured to allow drag and the OnDrawingChange event was configured to return the coordinates.
• ROU-4361 - Now, the Map’s preview images were optimised in order to reduce the module size.
• ROU-4370 - Fixed an issue that caused the Map_Initialized event not to run after the first time a Map was created.
  This occurred when leaving a screen with a Map block (Google Maps) and returning to it afterwards.