CityLens releases

To install CityLens version 2.0.0 or later, install the DGCLI utility version 3 and follow the update instructions.

2.3.0

Release date: 2026-06-10

Dependencies

Before updating CityLens to version 2.3.0, make sure that the required dependency components of the correct versions are installed:

Component	Minimum required version
DGCLI utility	3
Core services	2.1.0
API Platform	2.47.0
2GIS Pro	2.1.0

For more details, see the Updating CityLens section.

New

Service	Changes
CityLens API and CityLens Routes API	Enabled uploading points from a file to create a route in the Task Planner.
CityLens Routes UI	Added the progressDeadlineSeconds parameter for specifying the maximum time for deploying the service in Kubernetes. See the values.yaml example on GitHub. In the Task Planner, enabled excluding road segments from the route.

Breaking changes and backward compatibility

Service	Changes
CityLens API and CityLens Routes API	Implemented a role model for managing access of employees to the Task Planner: Added the routes.endpointInternalApiKey.users and routes.adminCredentials.cookieSigningKey mandatory parameters. Removed the routes.api.openApi and routes.realtimeDataApi.openApi parameters. After upgrading the service migrate existing users to the new role model: see the After installing instruction. See the values.yaml example on GitHub and the updated configuration file.
CityLens Routes UI	Added the env.CATALOG_API_KEY mandatory parameter for specifying the API key for working with Catalog APIs. See the values.yaml example on GitHub and the updated configuration file.

Bug fixes and enhancements

Service	Changes
CityLens API and CityLens Routes API	In the Task Planner: Now, the route is rebuilt when editing a task when road exclusion filters are changed. Fixed errors in retrieving detour statistics. Fixed issues in Hangfire service operation: now, one-time CronJobs are created. Now, basemaps are bound to a company instead of a user. Improved processing of detours in real time. Changed system error codes. Added task sorting by status in the list on the Tasks tab. Now, the user is granted access to all territory projects if they have access to the territory. Enabled editing territories and projects for drivers.
CityLens Routes UI	In the Task Planner: Added sorting of drivers in the list by the time of their last activity on the Drivers tab. Fixed the display of task progress on the project page. Added redirection of users without a company to the Platform Manager. Fixed the display of data in the tooltip when hovering over a polygon. Added translations for interface errors. Fixed errors in route calculations when editing a task. Now, tourist routes are not selected when selecting roads during task creation.

2.2.0

Release date: 2025-12-05

Dependencies

Before updating CityLens to version 2.2.0, make sure that the required dependency components of the correct versions are installed:

Component	Minimum required version
DGCLI utility	3
Core services	2.1.0
API Platform	2.47.0
2GIS Pro	2.1.0

For more details, see the Updating CityLens section.

New

Service	Changes
CityLens API and CityLens Routes API	Enabled building routes using points on the map in the Task Planner.

Breaking changes and backward compatibility

Service	Changes
CityLens API and CityLens Routes API	Added the following required parameters for accessing the Task Planner and internal services: routes.adminCredentials.password routes.adminCredentials.username routes.endpointInternalApiKey.dataScience routes.endpointInternalApiKey.companies See the values.yaml example on GitHub and the updated configuration file.

2.1.0

Release date: 2025-10-16

Dependencies

Before updating CityLens to version 2.1.0, make sure that the required dependency components of the correct versions are installed:

Component	Minimum required version
DGCLI utility	3
Core services	2.0.0
API Platform	2.44.0
2GIS Pro	2.1.0

For more details, see the Updating CityLens section.

New

Service	Changes
CityLens API and CityLens Routes API	Enabled logging SQL queries: see parameters routes.api.logging.extendedSqlLogging, routes.worker.logging.extendedSqlLogging, and routes.realtimeDataApi.logging.extendedSqlLogging. Enabled viewing route information and the last activity point of a driver on the map in the Task Planner. See the values.yaml example on GitHub.
CityLens Routes UI	Added an environment variable env.METRICS_API_URL to specify the metrics service address: see the values.yaml example on GitHub.

Breaking changes and backward compatibility

Service	Changes
CityLens API and CityLens Routes API	Renamed the routes.api.logging.extended parameter for logging REST requests to routes.api.logging.extendedRestLogging. Moved all settings for connecting to databases to a separate routes.postgres group: Moved the routes.postgres parameter group to routes.postgres.api. Moved the routes.hangfire.postgres parameter group to routes.postgres.hangfire. Moved the routes.realtimeDataApi.postgres parameter group to routes.postgres.realtimeDataApi. Combined the routes.postgres.maxPoolSize and routes.postgres.pooling parameters for configuring the PostgreSQL connection pool into the routes.postgres.api.poolSize group. See the values.yaml example on GitHub and the updated configuration file.
CityLens Routes UI	Added a mandatory environment variable env.MAPGL_DEFAULT_CENTER to set the coordinates of the default map center: see the values.yaml example on GitHub and the updated configuration file.

2.0.0

Release date: 2025-09-30

Dependencies

Before updating CityLens to version 2.0.0, make sure that the required dependency components of the correct versions are installed:

Component	Minimum required version
DGCLI utility	3
Core services	2.0.0
API Platform	2.44.0
2GIS Pro	2.0.0

For more details, see the Updating CityLens section.

Previous releases

You can find information about previous releases in the release archive.