On-Premise releases

1.36.0

Release date: 2025-03-11

New

Service/API	Description
License service	Enabled specifying the logging level: see the license.log.level parameter. Enabled specifying the log format: see the license.log.format parameter. See the values.yaml example on GitHub.
API Keys service	Enabled specifying tolerations in Kubernetes: see the import.tolerations and migrate.tolerations parameters. See the values.yaml example on GitHub.
Maps API (MapGL JS API)	See the full list of changes since version 1.56.0 till version 1.57.0.
Maps API (Styles API)	Enabled specifying tolerations in Kubernetes: see the migrate.tolerations parameter. See the values.yaml example on GitHub.
Search API (Catalog APIs)	Enabled specifying tolerations in Kubernetes: see the importer.tolerations parameter. See the values.yaml example on GitHub.
Navigation API (Navi-Router)	Enabled specifying a service token for sharing Routing API usage statistics: see the keys.apis.routing-api parameter. See the values.yaml example on GitHub, and see the updated configuration file.
Pro API	Enabled specifying tolerations in Kubernetes: see the assetImporter.tolerations parameter. See the values.yaml example on GitHub.
CityLens (Routes UI)	Enabled support for additional PKCE (Proof Key for Code Exchange) key verification for OIDC (OpenID Connect) authentication.

Breaking changes and backward compatibility

Service/API	Description
API Keys service	Disabled configuring Redis in the configuration file. If you were using a Redis instance configured in the configuration file, set up an external Redis instance and migrate your workloads to it before upgrading the API Keys service version. See the values.yaml example on GitHub.

Bug fixes and enhancements

Service/API	Description
License service	Fixed display of license expiration year when requesting status and in logs: now the full year is displayed instead of the last two digits.

1.35.0

Release date: 2025-02-26

New

Service/API	Description
API Keys service	Upgraded Node.js to version 22. Added a parameter for enabling single partner mode (that all users are bound to) when using an external provider for OIDC (OpenID Connect) authentication: see the api.oidc.enableSinglePartnerMode parameter. Added a parameter for enabling an external OIDC provider without access to user management: see the api.oidc.enableExternalProvider parameter. Enabled specifying a limit on how many failed cron jobs should be kept: see the cron.failedJobsHistoryLimit parameter. See the values.yaml example on GitHub.
Maps API (MapGL JS API)	See the full list of changes since version 1.55.0 till version 1.56.0.
Maps API (Styles API)	Added a parameter for specifying an S3 compatible storage region: see the s3.region parameter. Enabled connecting to an S3 compatible storage via HTTPS: see the s3.secure and s3.verifySsl parameters. See the values.yaml example on GitHub and also see the updated configuration file.
Maps API (Tilegen API)	Added a new Tilegen API service for creating vector tiles from user data. See the updated description of map services architecture and Tilegen API installation instruction.
Navigation API (Navi-Castle, Navi-Restrictions)	Enabled specifying a limit on how many failed cron jobs should be kept: see the cron.failedJobsHistoryLimit parameter in the values.yaml example on GitHub (example for Navi-Castle) and also see the updated configuration files.
Navigation API (Navi-Router)	Added a parameter for specifying a time delay before terminating a container: see the preStopDelay parameter. Added a parameter for specifying the Kubernetes grace period: see the terminationGracePeriodSeconds parameter. Enabled specifying a field name in logs: see the router.logMessageField parameter. See the values.yaml example on GitHub.
Navigation API (Navi-Front)	Enabled specifying the list of additional sidecar containers: see the sidecars parameter. Enabled support of the multimodal routing service: see the front.multimod parameters block. Enabled configuring keep-alive connection settings: see the front.keepalive parameter. Enabled adding multiple services to the namespace: see the navigroup parameter. Added a block for specifying nginx settings: see the nginx parameters block. Enabled overriding default location values: see the locationBlock, carroutingLocation, distMatrixCtxLocation, hullLocation, and multimodLocation parameters. See the values.yaml example on GitHub.
Navigation API (Distance Matrix Async API)	Enabled support for building routes for trucks. To use this navigation type, specify a corresponding rule in the rules.yaml file, install a separate Navi-Attractor service, and specify the dm.archiver.enabled, rbac, serviceAccount, kafka.taskTopicRules, kafka.attractTopicRules parameters blocks, and the keys.truckToken parameter in the values.yaml file for Distance Matrix Async API. See the installation instruction for navigation services. Added a parameter for specifying an S3 compatible storage region: see the s3.region parameter. Added a block for configuring Kafka operation in several data centers (creating a multi-DC architecture): see the multiDc parameters block. Added new Kafka topics: Topic for obtaining Navi-Attractor task results: see the kafka.attractTopic parameter. Topic for obtaining results of oneToMany type tasks: see the kafka.oneToManyTopic parameter. Topic for integration with the VRP service: see the kafka.vrpStatusTopic parameter. Enabled specifying the routing transport type (car or truck) in the topics that Distance Matrix Async API service sends requests to: see the kafka.taskTopicRules.type parameter. Added a block for configuring rules for matching query types with Navi-Attractor task topics: see the kafka.attractTopicRules parameters block. Added a parameter for specifying a service token for truck routes: see the keys.truckToken parameter. See the values.yaml example on GitHub and also see the updated configuration file.
Pro API	Enabled specifying the number of replicas for a Permissions API pod: see the permissions.pod.replicaCount parameter. Added new parameters for configuring a cron job for importing data: Enabled specifying Kubernetes Secrets for accessing the Docker registry where service images reside: see the assetImporter.settings.imagePullSecrets parameter. Enabled setting a time-to-live for completed cron jobs in Kubernetes: see the assetImporter.settings.ttlSecondsAfterFinished parameter. Enabled specifying a limit on how many failed cron jobs should be kept: see the assetImporter.failedJobsHistoryLimit parameter. Enabled automatic creation of Kafka topics: see the kafka.createTopics parameter. See the values.yaml example on GitHub and also see the updated configuration file.
Pro UI	Updated the configuration file: Enabled specifying a brand in the Platform Manager: see the ui.auth.brand parameter. Enabled working with custom tiles: see the ui.zenith parameters block. See the values.yaml example on GitHub. Enabled customizing the list of data attributes in a short help (in the tooltip) that appears when you hover the cursor over an item on the map. Enabled setting up unlimited access to view a dashboard via a link and setting up access for unauthorized users.
CityLens	Enabled specifying CityLens Routes API settings: see the routes parameters block. Enabled support for displaying driver information from the OIDC provider in CityLens Web and the Frames and Drivers datasets in Urbi Pro: see the api.auth.storeOIDCUserinfoFields parameter. Enabled specifying the security protocol in Kafka: see the kafka.securityProtocol parameter. Enabled configuring SASL (Simple Authentication and Security Layer) authentication in Kafka: see the kafka.saslMechanism parameter. Added a parameter for specifying the dataset ID for uploading objects: see the pro.objectsAssetId parameter. Added the Detection Localizer service for localizing recognized objects (a dataset Objects in Urbi Pro): see the worker.detectionLocalizer parameters block. If you add this block, make sure that the kafka.topics.objectsLifecycle parameter is added to the configuration file and the kafka.topics.proObjects topic specifies the Objects dataset in Urbi Pro. Added a Lifecycle Controller: see the worker.lifecycleController parameters block. See the values.yaml example on GitHub and also see the updated configuration file.
Platform Manager	Added Styles API service to the monitoring page (Status Page). Updated the configuration file: Added a parameter for configuring statuses in Styles API: see the ui.status.mapStyles parameter. Enabled specifying domains allowed redirecting to from the authentication page (/signup) in the Platform Manager after authentication is completed: see the ui.redirectSafeDomains parameter. Enabled configuring OIDC authentication in the application: see the ui.oauth settings block. Added a parameter for specifying the URL of the API Keys service host: see the ui.platform.api.url parameter. Added parameters for configuring Ingress: see the ui.ingress.className, ui.ingress.hosts, and ui.ingress.tls parameters. See the values.yaml example on GitHub and also see the updated configuration file.

Breaking changes and backward compatibility

Service/API	Description
Navigation API (Navi-Front, Navi-Router)	Updated the configuration file structure: renamed the scaling policy hpa.scaleDownStabilizationWindowSeconds and hpa.scaleUpStabilizationWindowSeconds parameters to hpa.scaleUp and hpa.scaleDown. See the values.yaml example on GitHub (example for Navi-Front).
Navigation API (Distance Matrix Async API)	Enabled support for building routes for trucks and changed the installation process of Distance Matrix Async API, including building car routes. To continue using Distance Matrix Async API for building routes for cars, specify the corresponding rule in the rules.yaml file, install a separate Navi-Attractor service, and specify the kafka.taskTopicRules and kafka.attractTopicRules parameters blocks in the values.yaml file. See the updated architecture description and installation instruction for navigation services. If you are using PostgreSQL databases for Distance Matrix Async API with public schemas, update the task status types by running the following queries: ALTER TYPE public."statusvalues" ADD VALUE 'ATTRACT_PUSHED'; ALTER TYPE public."statusvalues" ADD VALUE 'ATTRACT_READY'; ALTER TYPE public."statusvalues" ADD VALUE 'ATTRACT_PROCESSED'; ALTER TYPE public."statusvalues" ADD VALUE 'ONE_TO_MANY_PUSHED'; ALTER TYPE public."statusvalues" ADD VALUE 'ONE_TO_MANY_READY'; ALTER TYPE public."statusvalues" ADD VALUE 'MERGER_PUSHED'; ALTER TYPE public."statusvalues" ADD VALUE 'MERGER_IN_PROGRESS';
Pro API	Updated the configuration file structure: Removed the api.settings.allowAnyOrigin parameter for configuring CORS policies and replaced with the api.settings.corsOrigins parameter. Removed the assetImporter.enabled parameter. Now it is mandatory to use the assetImporter parameters block for configuring cron jobs for data import. Removed the api.openApi.servers parameter. See the values.yaml example on GitHub and also see the updated configuration file.
Pro UI	To work with custom tiles, update MapGL JS API to 1.54.1 version or later. Removed the ugc value of the ui.auth.oAuthProvider parameter. New available values are keycloak (deprecated) and openid. Removed the stylesImporter.successfulJobsHistoryLimit parameter for specifying a limit on how many completed cron jobs should be kept. Removed the ui.auth.userDataApiUrl parameter and replaced with the ui.auth.platformManagerHost parameter. See the values.yaml example on GitHub.
CityLens	Now for working with CityLens you need to install the CityLens Routes API, CityLens Routes worker, and CityLens Routes UI services. See the updated architecture description and the installation instruction for CityLens. Before upgrading the version, prepare the PostgreSQL database for CityLens and update all values ​​in the localization_status column by running the query: UPDATE tracks SET localization_status = 2006; Added mandatory parameters for configuring CityLens Routes API: PostgreSQL database name: see the routes.postgres.database parameter. PostgreSQL database name that hangfire (Tasks Planner) can access: see the routes.hangfire.postgres.database parameter. URL for the navigation API integration: see the routes.navi.url parameter. Removed the worker.reporterProTracks.enabled parameter and replaced with the worker.reporterPro.enabled parameter to enable service integration with Urbi Pro. Removed the reporters parameters block and replaced with the following parameters: Configuring sources for detection localization: see the worker.reporterPro.predictors parameter. Time limit after which the track is considered loaded: see the worker.reporterPro.trackTimeoutDays parameter. Added a mandatory Kafka topic for synchronizing Detection Localizer with Urbi Pro: see the kafka.topics.proObjects parameter. Added a mandatory Kafka topic for the object lifecycle events: see the kafka.topics.objectsLifecycle parameter. See the values.yaml example on GitHub and also see the updated configuration file.
Platform Manager	Now the list of available playgrounds in the application is specified using the ui.playgrounds parameter. See the values.yaml example on GitHub and also see the updated configuration file.

Bug fixes and enhancements

Service/API	Description
Pro API	Added multilingual support for the uploading data API. Now when you upload a dataset, coordinates of objects are saved in their cards. Now the password specified in the postgres.api.ro.password parameter is used to connect to PostgreSQL in read-only mode. If it is not specified, then the password specified in the postgres.api.rw.password password is used. See the values.yaml example on GitHub.
Pro UI	Fixed the error of widgets displaying on the screen grid. Enabled displaying values ​​as percentages in the legend for all widgets (the Values in percentage field). Enabled selecting up to 30 organizations in the Firms filter (search for an organization by name) when creating a data sample.
Platform Manager	Fixed the error code when building a route in the Routing API playground if no route is found between the points. Updated the Platform Manager interface: Updated images on the playground previews on the Playgrounds page. Now you cannot change an email of the user on the Profile page. Moved the Country and City fields to the Company section on the Profile page. Hidden links to the User Agreement.

1.34.0

Release date: 2025-01-27

New

Service/API	Description
API Keys service	Updated the configuration file structure: Enabled TLS support for connection to Kafka: see the kafka.tls block for configuring TLS. Enabled specifying the security protocol in Kafka: see the kafka.securityProtocol parameter. Enabled configuring SASL (Simple Authentication and Security Layer) authentication in Kafka: see the kafka.saslMechanism, kafka.username, and kafka.password parameters. Enabled configuring OIDC (OpenID Connect) authentication: see the api.oidc settings block. Enabled support for connecting to PostgreSQL from multiple hosts. See the values.yaml example on GitHub and also see the updated configuration file.
Navigation API (Navi-Back)	Enabled configuring estimated time of arrival (ETA): see the naviback.etaScheduleIndex.etaScheduleNodes parameter in the values.yaml example on GitHub.
Navigation API (Navi-Castle)	Updated the configuration file structure: Enabled specifying the projects to exclude: see the castle.excludeProjects parameter. Enabled specifying the logging level: see the castle.logLevel parameter. Enabled configuring the data retention period: see the castle.storePeriod settings block. Enabled configuring the header with the node name (X-Node): see the nginx.nodeHeader parameter. Enabled support for Ephemeral Persistent Volumes and specifying the storage type: see the persistentVolume.type parameter. See the values.yaml example on GitHub and also see the updated configuration file.

Breaking changes and backward compatibility

Service/API	Description
API Keys service	Backward compatibility of the API Keys service versions is affected. If you plan to upgrade the service to next versions, you need to upgrade it to the current version (1.34.0) first. If you plan to upgrade any navigation services, you need to upgrade the API Keys service first. Added the single service Routing API for building routes. When you upgrade the API Keys service, data migration is performed and access to the Routing API service is enabled for keys used for access to the Directions API, Pairs Directions API, and Truck Directions API. Now the Kafka group ID is specified via the KEYS_KAFKA_MAIN_GROUP_ID ​​environment variable. Updated the configuration file structure: moved the kafka.audit.bootstrapServers, kafka.audit.username, and kafka.audit.password parameters from the audit settings block and renamed to kafka.bootstrapServers, kafka.username, and kafka.password. See the values.yaml example on GitHub.
Navigation API (Navi-Back)	Enabled support for a new data format. The previous data format will no longer be supported and updated after 90 days. Upgrade the Navi-Back service to the current version (1.34.0) to continue receiving up-to-date navigation data.
Navigation API (Navi-Castle)	Updated the configuration file structure: Renamed the castle.restrictions.host parameter for the Restrictions API base URL to castle.restrictions.url. Now the parameter is empty by default. Now the persistentVolume.storageClass parameter is empty by default. See the values.yaml example on GitHub.

Bug fixes and enhancements

Service/API	Description
API Keys service	The keysctl import command for importing data to On-Premise now returns an error if the data contains invalid segments.
Catalog APIs	Improved data import process: Now the import is performed for each project in its own transaction. If the connection to the database is lost for a short time, the import continues without errors.

1.33.1

Release date: 2025-01-09

Bug fixes and enhancements

Service/API	Description
Maps API, Search API, Traffic API Proxy	Fixed issues with running Floors API, Search API, and Traffic API Proxy as a non-root user.

1.33.0

Release date: 2024-12-27

New

Service/API	Description
Maps API	See the full list of changes for MapGL JS API since version 1.53.0 till version 1.55.0. For MapGL JS API and Floors API, updated the configuration file structure: Enabled configuring service injection into Kubernetes environment variables: see the enableServiceLinks parameter. Enabled specifying the Kubernetes grace period: see the terminationGracePeriodSeconds parameter. See the values.yaml examples on GitHub (example for MapGL JS API).
Search API	Enabled configuring service injection into Kubernetes environment variables: see the enableServiceLinks parameter. Enabled specifying the Kubernetes grace period: see the terminationGracePeriodSeconds parameter. See the values.yaml example on GitHub.
Navigation API	For Navi-Castle and Navi-Front, enabled configuring service injection into Kubernetes environment variables: see the enableServiceLinks parameter. See the values.yaml examples on GitHub (example for Navi-Castle).
CityLens	Enabled support for Map Matching API for tracks and frames: see the worker.mapMatcher settings block. Enabled specifying the maximum number of extra connections in the pool: see the web.pgPoolMaxOverflow parameter. Enabled specifying the timeout in Kafka: see the kafka.produceTimeoutSeconds parameter. See the values.yaml example on GitHub.
Traffic API Proxy	Enabled configuring service injection into Kubernetes environment variables: see the enableServiceLinks parameter. Enabled specifying the Kubernetes grace period: see the terminationGracePeriodSeconds parameter. See the values.yaml example on GitHub.
Administration	Added guide on cleaning old data in the storage.

Breaking changes and backward compatibility

Service/API

Description

Pro API

Updated the configuration file structure: Removed the permissions.settings.enabled parameter. Now it is mandatory to specify the permissions.settings.auth.apiKey parameter to use the Permissions API. Replaced the postgres.connectionString, postgres.connectionStringReadonly, postgres.password parameters with the postgres.api.rw and postgres.api.ro settings blocks. See the values.yaml examples on GitHub and also see the updated configuration file.

Bug fixes and enhancements

Service/API	Description
CityLens	Improved precision of driver distances (in km) in Drivers dataset in Pro.

1.32.0

Release date: 2024-11-28

New

Service/API	Description
API Keys service	Enabled TLS support for connecting to PostgreSQL: see the postgres.rw.tls and postgres.ro.tls settings blocks in the values.yaml example on GitHub.
Catalog APIs	Enabled support for configuring security policies for pods: see the podSecurityContext parameter in the values.yaml example on GitHub.
Pro UI	Enabled creating dashboards instead of layer groups. Enabled creating widgets on dashboards with different types of graphs for visualizing data samples. Enabled viewing uploaded data as its real geometries (lines and polygons) before creating a layer. Added fog and sky display on the map and enabled configuring a larger map tilt angle.
Pro API	Enabled uploading files with data in the date and time format YYYY-MM-DD HH:MM:SS. Enabled viewing a dashboard shared via a link without logging in to Pro. Enabled support for PostgreSQL 15.

Breaking changes and backward compatibility

Service/API	Description
Tiles API	Updated the configuration file structure: Renamed the proxy.access.bss.enabled parameter to proxy.access.stat.enabled. Renamed the proxy.access.bss.url parameter to proxy.access.stat.url. See the values.yaml example on GitHub.
Pro UI	Replaced layer groups with dashboards with the same ID. Now you can manage layers only within a dashboard.

Bug fixes and enhancements

Service/API	Description
Pro API	Fixed an issue that occurred when updating filters with parallel requests. Prohibited adding permissions to all territories (*) and specific territories at the same time in the Permission UI. Improved data import process: Fixed an issue where data import fails due to a big number of files in an S3 compatible storage. Added a check for the availability of all S3 compatible storages before starting data import in scheduler mode. Set a limit on failed jobs for data import.
Pro UI	Updated navigation in the left menu: deleted the Layers tab and added the Dashboards tab. Updated the menu and added display of the IDs of datasets uploaded via API on the Data tab. Disabled supplying of immersive models to On-Premise build. In the dialog box for configuring data aggregation parameters: Enabled dragging and dropping parameters. Fixed the mechanism for selecting available attributes.
CityLens	Improved frame uploading stability for the mobile app.

1.31.0

Release date: 2024-11-07

New

Service/API	Description
Maps API (MapGL JS API)	See the full list of changes since version 1.51.0 till version 1.53.0.
Maps API (Floors API)	Enabled configuring custom certificates. See the customCAs settings group in the updated configuration file.
Navigation API (Navi-Back)	Enabled setting the following values: Threshold value of memory usage that triggers cache cleanup: see the naviback.clearCacheThreshold parameter. Time intervals between engine updates: see the naviback.clearCacheThreshold parameter. For more details, see the values.yaml example on GitHub.

1.30.0

Release date: 2024-10-24

New

Service/API	Description
API Keys service	Added FreeRoam API service for the free navigation mode without routes. Added the dispatcher worker to send audit logs to Kafka via the table and added the cleaner cron job to clean sent messages from the audit log table. See the values.yaml example on GitHub. Added metrics for the number of created audit logs keys_audit_occurred_events_total and the number of audit logs sent to Kafka keys_audit_delivered_events_total.
Tiles API	Added the region parameter to specify the region of the installation artifacts storage. See the dgctlStorage settings blocks in the updated configuration file.
Traffic API Proxy	Enabled: Configuring workers: see the worker settings group. Configuring logging: see the log settings group. Configuring keep-alive timeout: see the keepaliveTimeout parameter. Add custom location and server blocks. See the updated configuration file.
Pro API	Added the api.settings.layerGeneration settings block and the isochroneLayerMaxPointsCount parameter to limit isochrones creating depending on the number of points in the layer. Added the kafka.useReplicaTopics parameter for using topic replica if multiple Kafka clusters are created. See the values.yaml example on GitHub.
CityLens	Added the web.pgPoolSize parameter for configuring pool connection size. See the values.yaml example on GitHub.

Breaking changes and backward compatibility

Service/API

Description

Pro API

Updated the configuration file structure: Moved the name service parameter appName from the api.pod setting block to the api blocks group. Moved the enableUserAssetsImporter and enableAssetsStreaming parameters to the api.settings.backgroundJobs settings block. Renamed the permissionsApiKey parameter to apiKey and moved it to the permissions.setting.auth settings block. See the values.yaml example on GitHub.

Bug fixes and enhancements

Service/API	Description
Pro API	Added automatic creating of an empty layer group for new users if automatic registration is enabled.
CityLens	Improved EXIF images validation and processing mechanism. Added the App version field on frame cards in Frames dataset in Pro.

1.29.0

Release date: 2024-10-02

New

Service/API	Description
License service	Added the region parameter to specify the region of the installation artifacts storage and the region of the License service states storage. See the dgctlStorage and the persistence settings blocks in the updated configuration file.
Navigation API	Enabled configuring custom certificates for Navi-Castle, Navi-Back, Distance Matrix Async API, and Restrictions API. See the customCAs settings block in the updated configuration file (example for Navi-Castle).

Breaking changes and backward compatibility

Service/API	Description
MapGL JS API	Renamed the following parameters: MAPGL_ICONSPATH to MAPGL_ICONS_URL MAPGL_MODELSPATH to MAPGL_MODELS_URL See the updated configuration file.
Pro API	Updated the configuration file structure: Moved parameters related to the service configuring (e.g., resources, ingress) and license key parameter (licenseKey) from separate settings blocks to the api blocks group. Moved parameters from the api settings block (e.g., serviceAccount, tempPath) to the separate blocks of the api group (e.g., api.service, api.settings). Moved permissions parameters to the separate settings block (permissions). Moved the data import job name parameter (appAssetImporterName) to the assetImporter settings block, and some parameters from the assetImporter settings block (e.g., maxParallelJobs) to the separate block (assetImporter.settings). See the full list of moved parameters on GitHub, and the updated configuration file.

Bug fixes and enhancements

Service/API	Description
License service	Improved the mechanism of creating files for requesting a license: now the files are created synchronously before the application is launched. Updated the instruction on getting a license when the Kubernetes API server certificate is updated.
CityLens	Improved the frame uploading mechanism for the mobile app.

1.28.2

Release date: 2024-09-18

New

Service/API	Description
Maps API (MapGL JS API)	See the full list of changes since version 1.50.1 till version 1.51.0.

1.28.0

Release date: 2024-09-11

New

Service/API	Description
Platform Manager	Enabled uploading map styles created using the Style editor (Styles API must be installed). For a detailed instruction on uploading styles, see Installing maps API. Added new pages to the Platform Manager interface: listing map styles and uploading style archive. To enable these pages, add map_styles to the list of values of the ui.pages parameter (see the values.yaml example on GitHub). Enabled specifying a map style ID in the MapGL JS API sandbox to verify how the style looks before using it. Added a new parameter ui.mapStyles.url to the Platform Manager configuration file to specify the styles API URL. See the values.yaml example on GitHub.
Maps API	Added the Styles API service that enables convenient loading of customized map styles to the On-Premise environment. See the updated description of Maps API architecture and Styles API installation instruction.
Navigation API (Navi-Back)	Enabled support of barrier card IDs. In the Isochrone API and the Distance Matrix API, renamed the mode parameter to transport (backward compatibility is provided). In the Pairs Directions API and the Routing API, renamed car and pedestrian values of the transport parameter to driving and walking correspondingly (backward compatibility is provided).

Breaking changes and backward compatibility

Service/API	Description
Navigation API (Distance Matrix Async API)	The s3.publicNetloc value now must contain a scheme: http:// or https://. See the values.yaml example on GitHub.

Bug fixes and enhancements

Service/API	Description
Navigation API (Navi-Back)	Improved the algorithm of selecting an intermediate part in routes with intermediate points. Seasonal limitations are now considered when searching for a route on public transport with no timetable. Cleaned up noise in logs. Fixed the process of updating engines when terminating service operation. Fixed prefix configuration issues when logging in the JSON mode. Fixed an issue that changed the starting time of a route on public transport if a pedestrian part from the starting point to the metro was missing.
Navigation API (Distance Matrix Async API)	Fixed issues with connecting to Apache Kafka using mTLS.

1.27.0

Release date: 2024-08-30

New

Service/API	Description
Maps API (MapGL JS API)	Added new environment variables. See the env settings group in the updated configuration file. See the full list of changes since version 1.49.0 till version 1.50.1.
Catalog APIs	Enabled configuring the number of Search API connections. See the search.minConnections, search.maxConnections, and search.maxOpenRequests parameters in the values.yaml example on GitHub.
Search API	Enabled configuring custom certificates. See the customCAs settings group in the updated configuration file.
Pro API	Enabled uploading custom data using API. Enabled uploading files with custom data in the .kml, .kmz, and .shp formats. Enabled support of the Well-Known OpenID Configuration. See the auth.wellKnownConfigEndpoint parameter in the values.yaml example on GitHub. Removed the appUserAssetImporterName parameter.
Pro UI	Enabled uploading custom data with attributes of the date type. Enabled creating a colored legend for attributes of the text type.
Platform Manager	Upgraded the minimum version of Node.js to 20.0.0.

Breaking changes and backward compatibility

Service/API	Description
Catalog APIs	Updated integration with the license service: Affected the backward compatibility with the On-Premise version 1.8.0 or lower. To connect Catalog APIs to the license service, use the HTTPS protocol now: see the license.url parameter in the updated configuration file.
Pro UI	Updated the configuration file structure: moved parameters related to deploy settings to separate groups from the ui settings group. See the full list of moved parameters on GitHub and the updated configuration file.

Bug fixes and enhancements

Service/API	Description
Platform Manager	Enabled automatic detection of a user locale when the user visits the main page. Updated sandbox pages with links to corresponding service documentation. Fixed an issue with a missing marker in the Geocoder API sandbox. Fixed an issue with incorrect creation of a request address in the Geocoder API sandbox.

1.26.0

Release date: 2024-07-25

New

Service/API	Description
All services	Added the revisionHistoryLimit parameter to configuration files for all services. See all files on GitHub.
Navigation API	Enabled support for the free navigation mode without routes (free roam). To use this navigation type, add a corresponding rule to the rules.yaml file and install a separate Navi-Back entity. See installation instructions for navigation services.
Pro UI	Changed configuration file parameters: Replaced the appStylesImporterName parameter with stylesImporter.name. Removed the stylesImporter.serviceAccount parameter. See the full values.yaml example on GitHub.
MapGL JS API	See the full list of changes since version 1.47.1 till version 1.49.0.

Breaking changes and backward compatibility

Service/API	Description
CityLens	Added settings for a new worker: see the worker.dashboardBatchEvents parameter group in the full values.yaml example on GitHub. Added new topics for Apache Kafka: kafka.topics.proDrivers for synchronizing driver tracks with Urbi Pro kafka.topics.tracksLifecycle for tracks lifecycle events See the updated configuration file.

1.25.0

Release date: 2024-06-27

New

Service/API	Description
Pro API	Enabled using an existing Kubernetes service account: see the api.serviceAccountOverride parameter in the full values.yaml example on GitHub.

1.24.0

Release date: 2024-06-19

New

Service/API	Description
Mobile SDK	Added architecture description and installation instructions for mobile SDK.
MapGL JS API	Updated values and descriptions of the env parameter group (see the updated configuration file). See the full list of changes since version 1.45.1 till version 1.47.1.
Floors API	Removed the import.enabled parameter for managing import tasks. See the full values.yaml example on GitHub.
Pro UI	Enabled setting a timeout for API requests on the client and server side. See ui.api.timeout and ui.api.serverTimeout parameters in the full values.yaml example on GitHub. Enabled customizing the browser tab title for an application using the Whitelabel Config.
CityLens	Enabled configuring custom certificates. See the the customCAs settings group in the updated configuration file.
Administration	Enabled changing the login of a manager (administrator who added a partner to the system) when editing the partner data.

Breaking changes and backward compatibility

Service/API	Description
Pro API	Added integration with the License service: Added mandatory licenseKey and license.url parameters. Removed the api.licensePartner parameter. See the updated configuration file.
CityLens	Replaced the pro.url parameter with a combination of pro.baseUrl and pro.framesAssetId parameters to set a Pro API URL and a dataset for uploading frames respectively. See the updated configuration file.

Bug fixes and enhancements

Service/API	Description
License service	Added the automountServiceAccountToken: true to the pod specification to set obligatory mounting of a directory with a Kubernetes certificate.
Pro API	Fixed category naming in the firms and demand aggregations.
Pro UI	Fixed tooltip display issues in the visualization settings.
CityLens	Updated CamCom integration. Improved logging.
Administration	Fixed issues when popups could display unchanged data on the key page after the data was edited.

1.23.0

Release date: 2024-05-28

New

Service/API	Description
Pro UI	Enabled adding maps from external sources in the WMS/WMTS format. To enable this function, set the ui.externalStyleManager.enabled parameter to true. See the full values.yaml example on GitHub. Enabled adding Mapbox tilesets as external map styles (internet access is required). To enable this function, get access to the mapbox_layout resource in the Permission UI and pass a Mapbox access token to the ui.mapbox.styleToken parameter during Pro UI installation. Removed the ui.mapgl.styleId parameter. Updated the interface in Arabic: now all texts and interface elements are oriented right to left (RTL).
Tiles API	Enabled managing the tries of creating import tasks: see the importer.retryInterval and importer.retryCount parameters in the full values.yaml example on GitHub.
License service	Added instructions on advanced steps for getting a license for corner cases when the default way of getting a license is not available.

Bug fixes and enhancements

Service/API	Description
Pro UI	Update navigation in the Pro interface: moved tabs for working with data and layers and for accessing user account to the left-side menu. Updated the shared access policy for layer groups: now a view-only link provides access to the layer group and external maps selected for it. Fixed issues with displaying layer settings. Fixed authorization issues.

1.22.0

Release date: 2024-05-06

New

Service/API	Description
Pro API	Enabled support for multiple formats of an external map thumbnail: .jpg, .jpeg, .png, .bmp, .webp, and .heic. Enabled configuring the process of copying and importing data during installation of a new version of the service: see the assetImporter.startOnDeployMode parameter in the full values.yaml example on GitHub.
Search API	Enabled TLS support for connecting Catalog APIs to PostgreSQL: see the api.postgres.tls and importer.postgres.tls parameter groups in the full values.yaml example on GitHub.
Navigation API	Updated the process of fetching installation artifacts for navigation services: now the --services=navi flag is used for fetching any navigation data (including road closures). Removed the --services=navi-restrictions value. See Updating navigation API services.

Breaking changes and backward compatibility

Service/API	Description
Pro API	Added the kafka.eventsTopic.name and kafka.eventsTopic.readerGroupId parameters for configuring the event management topic. See the updated configuration file.
CityLens	Removed the kafka.predictors parameter. Now predition topics are set using the kafka.topics.predictions parameter. See the updated configuration file.

Bug fixes and enhancements

Service/API	Description
Pro UI	Fixed the mechanism of language selection for error messages: now it consideres the language selected in the UI. Improved texts in pop-up windows during confirmation of entities removal.
Pro API	Improved logging of 401 and 403 code errors. Fixed issues during saving Apache Kafka messages. Improved the filtering mechanism: now when a firm is selected in a filter, its name is returned instead of the branch name.
API Keys service	Fixed display of a phone number when editing partner data. Fixed display of the button that switches password visibility in the Safari browser.

1.21.0

Release date: 2024-04-02

New

Service/API	Description
API Keys service	Updated the configuration file for installing the service: Enabled configuring custom certificates using the customCAs settings. Added new parameters to dgctlStorage settings for working with an S3 compatible storage of installation artifacts. Added administrator guide on managing API keys.
Search API	Updated the configuration file for installing the Catalog APIs: Enabled configuring custom certificates using the customCAs settings. Added new parameters to dgctlStorage settings for working with an S3 compatible storage of installation artifacts.
Navigation API	Updated several parameters for installing Restrictions API: Renamed the db settings block to postgres. Added naviBackHost and naviCastleHost parameters. Renamed the api.api_key parameter to api.key. Renamed the cron.max_attributes_fetcher_rps parameter to cron.maxAttributesFetcherRps. See the full list of pamateres on GitHub.
CityLens	Updated the description of kafka.topic parameters: see the updated configuration file.

Breaking changes and backward compatibility

Service/API	Description
CityLens	Renamed the worker.reporterProTracks.replicas parameter to worker.reporterProTracks.enabled. See the values.yaml example on GitHub.

1.20.2

Release date: 2024-03-20

New

Service/API	Description
API Keys service	Enabled sending audit logs to Apache Kafka when a user is authenticated in the admin interface or a key is created in the admin interface. To use audit logs, enable the feature using featureFlags.enableAudit and configure message sending using kafka.audit (see the service Helm chart on GitHub).

1.20.0

Release date: 2024-03-18

New

Service/API	Description
Pro API	Translated descriptions of system datasets into Arabic.
Pro UI	Added mandatory parameters to the configuration file for service installation (see the installation instruction): dgctlStorage settings for working with the Installation Artifacts Storage new parameters in the ui.mapgl settings group for managing map styles Added optional parameters for service installation (see the full values.yaml on GitHub): ui.auth.oAuthProvider parameter to work with authentication tools following oAuth and OpenID Connect standards ui.whiteLabel settings to customize the application logo and favicons stylesImporter settings to import styles hpa settings to configure autoscaling

Breaking changes and backward compatibility

Service/API	Description
CityLens	Integrated CityLens with the License service. See the updated installation instruction. Renamed the api.auth.camcomToken parameter to api.auth.predictorsTokens.camcom. Added a mandatory map.tileserverUrl parameter that specifies a server for obtaining raster tiles.
Navigation API	Renamed several parameters for installing Navi-Router: router.keyManagementService to keys keyManagementService.host to keys.url router.castleHost to router.castleUrl

Bug fixes and enhancements

Service/API	Description
Pro API	Fixed issues with reading streaming datasets.

1.19.0

Release date: 2024-02-27

New

Service/API	Description
Pro API	Enabled specifying region of the deployment artifacts storage and disabling playload signature in it. Additionally, updated the list of S3 bucket settings. See the updated [configuration file] (/en/on-premise/deployment/pro). Changed the method of writing files to an S3 storage: now the Ceph client is used.
Pro UI	Enabled aggregating data for polygons: you can calculate the total quantity of objects and a maximum/minimum value of a specified metric. Enabled customizing the Pro logo by using the Whitelabel Config.
MapGL JS API	See the full list of changes since version 1.42.0 till version 1.45.1.
Platform Manager	Added documentation for the Platform Manager service: see the architecture description and installation instructions.
CityLens	Added documentation for the CityLens service: see the architecture description and installation instructions.

Bug fixes and enhancements

Service/API	Description
Pro API	Improved verification of user access rights for a project. Fixed handling of requests for obtaining filers if duplicated attributes are passed. Improved cashing of data filters (for uploaded and streaming datasets). Fixed issues during data aggregation for layers with polygons. Added information about territories to the system datasets.
Pro UI	Added a notification that requires refreshing the browser page if a user has been working with Pro for more than 5 days without refresh. Removed limitations of the size of a created data sample. Added information about the number of objects in each dataset to the dataset library. Added information about the source layer to the tooltip that is displayed on hovering over the aggregated data visualization. Fixed the search of firms in filters of various datasets. Fixed issues in localized texts.

1.18.0

Release date: 2024-01-24

New

Service/API	Description
License service	Added information on client and service licenses to the /status API. Updated settings to access the Trusted Platform Module (TPM): now you do not need to configure the access to the TPM host via the tpm.securityContext parameter (see the updated configuration file).
Pro UI	Enabled uploading custom data. Created the dataset library, which allows you to view, group, and manage datasets in a convenient way. Added a field for searching and filtering datasets in the dataset library. Enabled setting the default locale for the application using the APP_LOCALE environment variable. For example, if you set the variable to ar-AE, the application interface will be displayed in Arabic from the start. Added basic information about a dataset (description, date of creation or update, number of objects), which is displayed when the dataset is opened and the territory to filter data is not selected yet.
Pro API	Added the interface for managing tariffs of Urbi Pro users. Translated names of data filters to Arabic.

Bug fixes and enhancements

Service/API	Description
Pro UI	Fixed behavior of clicking and hovering over point data visualized by icons. Fixed an issue with adding a new layer to a group of layers when searching the dataset.
Pro API	Fixed import of files with large volume of data. Improved the process of updating filters in streaming datasets: now changes are displayed right after the update. Fixed verification of user rights to upload custom data. Fixed the algorithm of defining the list of territories in a dataset based on the region. Limited the access to prepared datasets: now only Firms and Buildings are available by default. Removed the display of territories list in the prepared datasets. Stopped cashing filters in streaming datasets if territories are not set.

1.17.0

Release date: 2023-12-29

New

Service/API	Description
License service	Disabled support of Kubernetes Persistent Volume as a storage of the License service states. Now you can use an S3 compatible storage only (see the updated persistence settings in the configuration file). Enabled configuring custom certificates using the customCAs settings in the configuration file.
Tiles API	Enabled configuring custom certificates using the customCAs settings in the configuration file. Changed the method of configuring the Apache Cassandra CA certificate: use the new customCAs settings instead of the cassandra.ssl.caCrt parameter.

Breaking changes and backward compatibility

Service/API	Description
License service	Backward compatibility of the License service versions is affected. If you upgrade from On-Premise versions 1.9.1 or lower, you need to upgrade On-Premise to the 1.16.0 version first (to get the latest version of the License service) and then upgrade to the 1.17.0 version.
Navigation API	Renamed the naviback.ecaHost parameter for defining the domain name of the Traffic API Proxy service. New parameter name is naviback.ecaUrl (see the updated Navi Back configuration file). Renamed the naviback.castleHost parameter for specifying the domain name of the Navi-Castle service. New parameter naviback.castleUrl specifies the service URL (see the updated Navi Back configuration file). Integrated Navi Back with the License service. See the updated installation instruction.

Bug fixes and enhancements

Service/API	Description
Tiles API	Fixed an issue causing the requests to vector tiles return error 500 instead of 204 if a missing tileset is requested. Fixed segment border tiles for Mapbox: now they are returned in full.
Navigation API	Fixed issues with launching Navi Castle in cases when importing data takes too much time.

1.16.0

Release date: 2023-12-12

New

Service/API	Description
Pro UI	Added translation of UI texts into Arabic language.
Pro API	Added descriptions of prepared data assets in Russian and English languages. Enabled display of "last updated" date for data sets and files. Enabled deleting all data from streaming assets (for example, the Frames data set). To do this, send an object with ID = __delete_all_objects. Enabled authorization using multiple API keys with different privileges. Added a new dgctlStorage.secure: bool parameter to the configuration file to enable working with an S3 compatible storage via HTTPS.
MapGL JS API	See the full list of changes since version 1.40.0 till version 1.42.0.
Catalog API	Enabled connecting to PostgreSQL via SSL.

Breaking changes and backward compatibility

Service/API	Description
Catalog API	Backward compatibility of Catalog API data versions is affected. Upgrade the service to the version 1.16.0 to use the latest data. Changes are also described in GitHub.

Bug fixes and enhancements

Service/API	Description
Pro API	Improved the experience of searching for administrative objects using queries containing hint words (for example, "district" or "city) in Arabic language. Improved the performance of search hints. Now if you select a street, a district, or a microdistrict from the hint list while searching for an object, a corresponding object is opened right away (only for Kingdom of Saudi Arabia projects).

1.15.0

Release date: 2023-12-01

New

Service/API	Description
Navigation API	For Navi-Castle, added new parameters to dgctlStorage settings for working with an S3 compatible storage of installation artifacts and new init settings of data import during service start. See the updated configuration file. Restrictions API artifacts can now be downloaded/updated using the --services parameter of DGCLI. See the command-line arguments reference.

Breaking changes and backward compatibility

Service/API	Description
Navigation API	Updated the names of router.keyManagementService.apis.* service tokens listed in the Navi-Router configuration. See the updated configuration file.

Bug fixes and enhancements

Service/API	Description
Navigation API	Added a new error message returned if Navi-Back fails to load a data package. Added a new critical error message returned if Navi-Castle fails to load files from S3.

1.14.0

Release date: 2023-11-15

New

Service/API	Description
Tiles API	Added support for Mapbox API: /mapbox/{tileset}/{z}/{x}/{y}.mvt
Pro UI	Upgraded Node.js to version 20. Enabled adding point objects to the uploaded data manually and removing such objects from the uploaded data.
Pro API	Enabled updating filters for any uploaded dataseta using the PUT /asset/filters method. Updated the dataset creation method with an optional asset_group_id parameter to specify the group to store the created dataset in.

Breaking changes and backward compatibility

Service/API	Description
API Keys service	Added mandatory dgctlStorage settings for working with the Installation Artifacts Storage. See the updated configuration file.

Bug fixes and enhancements

Service/API	Description
Pro UI	Fixed issues related to editing a layer with filtered data.
Pro API	Changed the response code returned when a client cancels a request: now a 2хх error is returned. Fixed access issues that occurred while creating or deleting an object in uploaded datasets. Changed the logic of granting access to territories upon user auto-registration.

1.13.0

Release date: 2023-10-25

New

Service/API	Description
Navigation API	Enabled Routing API features.
Tiles API	Added a new /wmts/WMTSCapabilities.xml endpoint to support WMTS data.
MapGL JS API	See the full list of changes since version 1.39.0 till version 1.40.0.
Pro UI	Removed the ID attribute type from the attribute definition form of the uploaded asset. Enabled visualization of camera markers upon selecting objects in the Frames asset.
Pro API	Enabled requesting metadata for uploaded assets. Added a hint about the limited visualization of the Buildings asset as one layer in a project. Enabled cloning a project from one user to another. Enabled additional filtering by context when the Firms asset is imported.

Breaking changes and backward compatibility

Service/API	Description
License service	Backward compatibility of the License service versions is affected. If you upgrade from On-Premise versions 1.9.1 or lower, you need to update the License service before updating other services.

1.12.0

Release date: 2023-10-13

New

Service/API	Description
Navigation API (Distance Matrix Async API)	Enabled connecting to the PostgreSQL database using mTLS. Use the dm.tls parameter block in the Helm configuration file. Enabled using non-public PostgreSQL schemas. Use the new dm.schema parameter in the Helm configuration file.

Bug fixes and enhancements

Service/API	Description
Navigation API	Now all Python code in the Docker images for Distance Matrix Async API is shipped as binaries.

1.11.0

Release date: 2023-09-22

New

Service/API	Description
Tiles API	Enabled setting authorization parameters for working with Cassandra via environment variables.
Floors API	Added new parameters for working with an S3 compatible storage. See the installation instructions.
Search API	Added new parameters for working with an S3 compatible storage. See the installation instructions.

1.10.0

Release date: 2023-09-06

New

Service/API	Description
License service	Added a new secure: bool parameter to the configuration file to enable working with an S3 compatible storage via HTTPS.
Tiles API	Enabled loading immersive tiles. Use a new subtype: immersive parameters in the configuration file. Added a new secure: bool parameter to the configuration file to enable working with an S3 compatible storage via HTTPS.
MapGL JS API	See the full list of changes since version 1.38.1 till version 1.39.0.

1.9.1

Release date: 2023-08-23

New

Service/API	Description
Floors API	Introduced support for Floors API that allows you display 3D floor plans on the map.
License service	Implemented a new process of obtaining a license.
MapGL JS API	See the full list of changes since version 1.36.1 till version 1.38.1.
Search API	Improved the search experience, in particular: Extended the set of synonyms in the search data. Improved handling of mistyped words. Improved accuracy of the list of words used for object search.

Breaking changes and backward compatibility

Service/API	Description
License service	Added new license.type and persistence parameters to the service configuration file.

Bug fixes and enhancements

Service/API	Description
Tiles API	Fixed connection issues between the Tiles API server and Cassandra. Previously, after the Cassandra cluster was restarted and all IP addresses were changed, the Tiles API could not reconnect to Cassandra.

1.5.0

Release date: 2022-12-06

New

Service/API	Description
MapGL JS API	See the full list of changes since version 1.30.0 till version 1.32.1.
Places API / Geocoder API / Suggest API	Introduced support for PostgreSQL v14, PostgreSQL v11 is deprecated. Introduced support for PostGIS v3.3, PostGIS v2.5 is deprecated.
Navigation APIs	Introduced support for Restrictions API. Introduced support for Directions API emergency mode. Introduced support for asynchronous requests to Distance Matrix Async API.
API Keys service	Golang updated to v1.19.1.

1.1.0

Release date: 2022-07-04

New

Service/API	Description
GIS Platform	Added the portal.max_body_size setting to the Helm chart, allowing you to control the maximum size of a file that can be uploaded via Portal web UI. Added the -k argument to the configure.sh configuration script, allowing you to skip the connection security verification when connecting via HTTPS.

0.1.9

Release date: 2022-04-05

First release of On-Premise includes the following services:

Service/API	Description
Maps	A set of services that allow displaying 2GIS maps in web applications and websites.
Search	A set of services that allow searching and retrieving information on various objects such as organizations, buildings, public places, etc.
Navigation	A set of services that allow building routes and getting information about travel time and distance between points on the map.
GIS Platform	A web-based solution for working with geospatial layers and performing geo-analytical tasks.