Релизы API-платформы

Чтобы установить сервисы API-платформы версии 2.44.0 и выше, установите утилиту 2GIS CLI версии 3 и следуйте инструкциям по обновлению.

2.47.0

Дата релиза: 2025-11-27

Зависимости

Перед обновлением любого сервиса в составе API-платформы версии 2.47.0 убедитесь, что установлены компоненты-зависимости нужных версий:

Компонент	Версия
Утилита 2GIS CLI	3
Базовые сервисы	2.1.0

Подробнее см. в разделе Руководство администратора → Обновление.

Новое

Сервис	Изменения
API карт (Styles API)	Обновлена версия сервиса, поддерживающая обновлённые версии MapGL и Zenith.
API карт (MapGL JS API)	См. полный список изменений с версии 1.66.0 по версию 1.67.0.
API карт (Tiles API)	Добавлена возможность подключения к Apache Cassandra через TLS. В конфигурационный файл добавлены параметры: cassandra.tls.enableHostVerification, cassandra.tls.deploySecret, cassandra.tls.ca, cassandra.tls.cert и cassandra.tls.key. См. пример values.yaml на GitHub, а также см. обновлённый конфигурационный файл.
Прокси для API пробок	Обновлена структура конфигурационного файла: Теперь в параметре proxy.host нужно указывать хост jam.api.2gis.com для сервисов карт и datagateway.api.2gis.com для сервисов навигации. Параметр proxy.licenseKey теперь обязателен, если proxy.locationDG имеет значение true. См. пример values.yaml на GitHub, а также см. обновлённый конфигурационный файл.
Менеджер Платформы	Выпущена мобильная версия Менеджера Платформы. В конфигурационный файл установки Менеджера Платформы добавлены новые параметры для указания URL сервисов: ui.mapStyles.entryPageUrl, ui.pro.entryPageUrl, ui.cityLens.entryPageUrl, ui.onpremise.entryPageUrl, ui.kitDocs.entryPageUrl. Улучшен пользовательский интерфейс веб-версии: Основная навигация перенесена из верхней панели в боковую панель слева. В навигационное меню добавлены ссылки на сервисы: Документация, Редактор стилей, Про, Ситискан, On-Premise. Добавлено всплывающее уведомление об использовании файлов Cookie. См. пример values.yaml на GitHub, а также см. обновлённый конфигурационный файл.

Изменения, влияющие на обратную совместимость

Сервис	Изменения
API карт (Tiles API)	Параметр cassandra.ssl переименован в cassandra.tls. См. пример values.yaml на GitHub, а также см. обновлённый конфигурационный файл.
API поиска (Catalog APIs)	Теперь расширение JsQuery не требуется для работы сервиса. Для оптимальной производительности рекомендуется обновить данные и запустить приложение с новой версией манифеста.
Прокси для API пробок	Параметр proxy.apiKey переименован в proxy.licenseKey. См. пример values.yaml на GitHub, а также см. обновлённый конфигурационный файл.
Сервис сбора статистики	Обновлена структура конфигурационного файла: Параметр kafka.sasl.createSecret удалён. Если в параметре kafka.sasl.secretName не указано имя секрета, новый секрет будет создан автоматически. Параметр kafka.sasl.jaas удалён. Вместо него используйте параметры kafka.sasl.jaasLoginModule, kafka.sasl.username и kafka.sasl.password для аутентификации в Apache Kafka по логину и паролю. См. пример values.yaml на GitHub, а также см. обновлённый конфигурационный файл.
Менеджер Платформы	Для корректной работы сервиса обновите сервис API-ключей до версии 1.140.0.

2.46.0

Дата релиза: 2025-11-17

Зависимости

Перед обновлением любого сервиса в составе API-платформы версии 2.46.0 убедитесь, что установлены компоненты-зависимости нужных версий:

Компонент	Версия
Утилита 2GIS CLI	3
Базовые сервисы	2.0.0

Подробнее см. в разделе Руководство администратора → Обновление.

Новое

Сервис	Изменения
API навигации (Navi-Back)	Параметр naviback.app_rule переименован в naviback.appRule. Предыдущее имя параметра действительно, но работает с предупреждением. См. пример values.yaml на GitHub, а также см. обновлённый конфигурационный файл. Параметр app_project переименован в appProject. Предыдущее имя параметра действительно, но работает с предупреждением. См. пример values.yaml на GitHub.
API навигации (Navi-Attractor)	Параметр attractor.app_rule переименован в attractor.appRule. Предыдущее имя параметра действительно, но работает с предупреждением. См. пример values.yaml на GitHub, а также см. обновлённый конфигурационный файл. Параметр app_project переименован в appProject. Предыдущее имя параметра действительно, но работает с предупреждением. См. пример values.yaml на GitHub.
API навигации (Navi-Splitter)	Параметр splitter.app_rule переименован в splitter.appRule. Предыдущее имя параметра действительно, но работает с предупреждением. См. пример values.yaml на GitHub, а также см. обновлённый конфигурационный файл. Добавлена возможность переопределять точку монтирования файлов конфигурации: см. параметр envoy.configFilepath в примере values.yaml на GitHub.
API навигации (Distance Matrix Async API)	Параметр s3.publicNetloc переименован в s3.publicUrl. Предыдущее имя параметра действительно, но работает с предупреждением. См. пример values.yaml на GitHub.

Исправленные ошибки/Улучшения

Сервис	Изменения
API навигации (Navi-Back, Navi-Attractor)	Обновлён путь к сертификатам Apache Kafka.
API навигации (Distance Matrix Async API)	Оптимизирована подготовка задач для больших матриц.

2.45.0

Дата релиза: 2025-10-30

Зависимости

Перед обновлением любого сервиса в составе API-платформы версии 2.45.0 убедитесь, что установлены компоненты-зависимости нужных версий:

Компонент	Версия
Утилита 2GIS CLI	3
Базовые сервисы	2.0.0

Подробнее см. в разделе Руководство администратора → Обновление.

Новое

Сервис	Изменения
API карт (Tiles API)	Добавлена возможность указывать источник, запросы из которого к Tiles API не будут проходить проверку ключа доступа: см. параметр proxy.access.skipExactOrigins. Добавлена возможность указывать определённые хосты Tiles API, данные о запросах к которым будут отправляться в сервис сбора статистики: см. параметр proxy.access.stat.registerExactHosts. См. пример values.yaml на GitHub.
API карт (MapGL JS API)	См. полный список изменений с версии 1.65.0 по версию 1.66.0.
API навигации	Добавлена возможность строить маршруты на общественном транспорте при помощи мобильного SDK. Чтобы начать работать с маршрутами на общественном транспорте, переустановите сервисы навигации с обновлённым файлом правил и затем используйте endpoint /ctx/3.0.
API навигации (Navi-Attractor)	Добавлена возможность переопределять точку монтирования файлов конфигурации: см. параметр attractor.configFilepath в примере values.yaml на GitHub.
API навигации (Navi-Back)	Добавлена возможность переопределять точку монтирования файлов конфигурации: см. параметры naviback.configFilepath и envoy.configFilepath в примере values.yaml на GitHub.
API навигации (Navi-Router)	Добавлена возможность переопределять имя файла с информацией о городах, предоставляемой сервисом Navi-Castle: см. параметр router.citiesFilename в примере values.yaml на GitHub.
API навигации (Navi-Front)	Добавлена возможность настраивать пробы работоспособности и пробы готовности контейнеров: см. группы параметров livenessProbe и readinessProbe и параметры customLivenessProbe и customReadinessProbe в примере values.yaml на GitHub.
API навигации (Distance Matrix Async API)	Добавлена возможность настраивать пробы работоспособности и пробы готовности контейнеров: см. группы параметров livenessProbe и readinessProbe и параметры customLivenessProbe и customReadinessProbe. Добавлена возможность настраивать формат логов: см. параметр dm.logFormat. Добавлена возможность переопределять точку монтирования файлов конфигурации: см. параметр dm.configFilepath. Удалён параметр dm.taskSplitSize. См. пример values.yaml на GitHub.

2.44.0

Дата релиза: 2025-09-30

Зависимости

Перед обновлением любого сервиса в составе API-платформы версии 2.44.0 убедитесь, что установлены компоненты-зависимости нужных версий:

Компонент	Версия
Утилита 2GIS CLI	3
Базовые сервисы	2.0.0

Подробнее см. в разделе Руководство администратора → Обновление.

Новое

Сервис	Изменения
API карт (MapGL JS API)	См. полный список изменений с версии 1.63.0 по версию 1.65.0.
API поиска (Catalog APIs)	В тело ответа на запрос к endpoint 3.0/markers добавлено поле items.trade_license с информацией о торговой лицензии организации.
Сервис сбора статистики	Добавлен новый сервис для сбора статистики использования API и расходования лимитов в рамках API-ключей. См. описание архитектуры и установки сервиса.