Commit b786ca
2026-03-20 07:55:50 GitLab Deploy: sync: deploy from GitLab commit 3c638da1| документация для интеграторов.md .. /dev/null | |
| @@ 1,1 0,0 @@ | |
| - | # Документация для интеграторов |
| документация для интеграторов/ресурсы компании.md .. /dev/null | |
| @@ 1,13 0,0 @@ | |
| - | --- |
| - | page_role: hub |
| - | audience: R2 |
| - | section: "Ресурсы компании" |
| - | --- |
| - | |
| - | # Ресурсы компании |
| - | |
| - | Раздел описывает управление ресурсами компании в Админ-панели SKIF.PRO: картографические слои, а также другие подразделы, доступные интегратору для настройки платформы. |
| - | |
| - | ## Подразделы |
| - | |
| - | - [Слои](Ресурсы-компании/Слои) — создание, настройка и управление WMS-слоями через Админ-панель |
| документация для интеграторов/ресурсы компании/слои.md .. /dev/null | |
| @@ 1,42 0,0 @@ | |
| - | --- |
| - | type: B |
| - | audience: R2 |
| - | source: S2 |
| - | section: Ресурсы компании/Слои |
| - | owner: "" |
| - | last_verified: "" |
| - | tested_by: "" |
| - | version: "" |
| - | --- |
| - | |
| - | # Картографические слои: архитектура и интеграция |
| - |  |
| - | |
| - | ## Для чего это нужно |
| - | |
| - | Картографические слои позволяют отображать данные внешних геоинформационных сервисов поверх базовой карты SKIF.PRO. Интегратор подключает WMS-источники (кадастр, метеоданные, корпоративные ГИС) через **Админ-панель** и назначает их компаниям — после этого все пользователи назначенных компаний могут включать слои на карте. |
| - | |
| - | ## Как это работает |
| - | |
| - | SKIF.PRO поддерживает слои по стандарту **WMS (Web Map Service)**. При включении слоя платформа отправляет запрос `GetMap` к внешнему WMS-серверу с параметрами текущего viewport (BBOX, WIDTH, HEIGHT, CRS). Сервер возвращает растровое изображение (PNG), которое накладывается поверх базовой карты. |
| - | |
| - | Слой создаётся один раз в **Админ-панели** и назначается одной или нескольким компаниям. После назначения все пользователи этих компаний получают возможность включать и выключать слой на карте — дополнительная активация не требуется. |
| - | |
| - | ## Сценарии применения |
| - | |
| - | **Массовое подключение отраслевых данных.** Интегратор создаёт набор WMS-слоёв (кадастр, зоны ограничения скорости, метеоданные) и назначает их всем обслуживаемым компаниям. |
| - | |
| - | **Корпоративные ГИС.** Компания с собственным ГИС-сервером публикует WMS-эндпоинт (зоны доставки, инфраструктура). Интегратор подключает его как слой — пользователи компании видят корпоративные данные прямо на карте мониторинга. |
| - | |
| - | **Государственные сервисы.** Подключение открытых WMS-источников: НСПД (кадастр), Росреестр, OpenWeatherMap. Особенность: российские госсервисы могут требовать сертификаты Минцифры и блокировать запросы с иностранных IP. |
| - | |
| - | ## Ограничения и важные условия |
| - | |
| - | - Поддерживается только протокол WMS. Тайловые сервисы (WMTS, TMS, XYZ) не поддерживаются в текущей версии. |
| - | - Одновременное включение нескольких слоёв увеличивает количество HTTP-запросов при каждом перемещении карты и может влиять на производительность. |
| - | - Технические требования к URL и серверу описаны в инструкции по созданию слоя. |
| - | |
| - | ## Связанные инструкции |
| - | |
| - | - [Как создать WMS-слой в Админ-панели](Слои/Как-создать-WMS-слой-в-Админ-панели) — пошаговая инструкция с требованиями к URL |
| - | - [Что такое картографические слои в SKIF.PRO](/Руководство-пользователя/Карта/Картографические-слои) — статья для конечных пользователей |
| документация для интеграторов/ресурсы компании/слои/map-6.webp .. /dev/null | |
| документация для интеграторов/ресурсы компании/слои/как создать wms-слой в админ-панели.md .. /dev/null | |
| @@ 1,134 0,0 @@ | |
| - | --- |
| - | type: A |
| - | source: S2 |
| - | audience: R2 |
| - | section: Ресурсы компании/Слои |
| - | owner: [Панасюк Кирилл Юрьевич] |
| - | last_verified: 2025-06-01 |
| - | tested_by: "Dmitriy Obrazumov" |
| - | version: [05.03.2026] |
| - | --- |
| - | |
| - | # Как создать WMS-слой в Админ-панели |
| - | |
| - |  |
| - | |
| - | ## Когда это нужно |
| - | |
| - | Необходимо подключить внешний WMS-картографический сервис (кадастр, ГИС, погодные данные) и сделать его доступным для одной или нескольких компаний на платформе. После создания слоя администраторы компаний смогут активировать его для своих операторов. |
| - | |
| - | ## Что потребуется |
| - | |
| - | - Доступ к **Админ-панели** SKIF.PRO с правами управления ресурсами компании |
| - | - URL WMS-сервиса, начинающийся с `https://` |
| - | |
| - | **Как получить URL WMS-сервиса:** |
| - | |
| - | URL WMS-запроса можно взять из браузерных инструментов разработчика при работе с нужным картографическим сервисом. В DevTools (вкладка Network) найдите запрос к сервису и скопируйте значение поля **Request URL**. |
| - | |
| - | Необходимо передавать **полный URL запроса** — вместе со всеми параметрами после `?`. Система использует URL как есть; динамические параметры (BBOX, WIDTH, HEIGHT) подставляются поверх уже имеющихся. |
| - | |
| - | Пример полного URL для сохранения: |
| - | ``` |
| - | https://nspd.gov.ru/api/aeggis/v3/36048/wms?REQUEST=GetMap&SERVICE=WMS&VERSION=1.3.0&FORMAT=image%2Fpng&STYLES=&TRANSPARENT=true&LAYERS=36048 |
| - | ``` |
| - | |
| - | > ⚠️ Не обрезайте URL до знака `?` — без параметров сервис не сможет определить слой и тип запроса. |
| - | |
| - | ## Пошаговая инструкция |
| - | |
| - |  |
| - | |
| - | ### Открыть раздел управления слоями |
| - | |
| - | 1. Войдите в **Админ-панель** SKIF.PRO. |
| - | 2. Перейдите в раздел **Ресурсы компании**. |
| - | 3. Выберите подраздел **Слои**. |
| - | |
| - | Откроется таблица со всеми созданными на платформе WMS-слоями. |
| - | |
| - | ### Создать новый слой |
| - | |
| - | 4. Нажмите кнопку **+ Добавить слой** в правом верхнем углу. |
| - | |
| - | Откроется модальное окно **Создание слоя**. |
| - | |
| - | 5. В поле **Интегратор** выберите интегратора, которому будет принадлежать слой. |
| - | |
| - | 6. В поле **Название слоя** введите понятное имя. |
| - | |
| - | Название будет видно администраторам компаний и операторам на карте. Используйте понятные имена: `Кадастр РФ`, `Погода OpenWeather`, `Зоны доставки`. |
| - | |
| - | Ограничения: до 500 символов, запрещены символы `<`, `>`, `&`, `"`. |
| - | |
| - | 7. В поле **URL слоя** вставьте URL WMS-сервиса. |
| - | |
| - | Требования к URL: |
| - | - Должен начинаться с `https://` |
| - | - Максимальная длина — 500 символов |
| - | - Локальные адреса (localhost, 192.168.x.x, 10.x.x.x) не поддерживаются |
| - | - Протоколы http://, file://, ftp://, data: не поддерживаются |
| - | |
| - | Тип слоя (WMS) определяется автоматически по URL. |
| - | |
| - | ### Назначить слой компаниям |
| - | |
| - | 8. В левой секции **Не присутствует в компаниях** найдите нужные компании. |
| - | |
| - | Используйте поле поиска для быстрого нахождения компании по названию. |
| - | |
| - | 9. Добавьте компании одним из способов: |
| - | |
| - | - Нажмите **+** напротив названия компании — добавит одну компанию. |
| - | - Отметьте несколько компаний чекбоксами → нажмите **Добавить в выбранные**. |
| - | - Нажмите **Добавить все** — перенесёт все компании в правую секцию. |
| - | |
| - | Добавленные компании переместятся в правую секцию **Присутствует в компаниях**. |
| - | |
| - | 10. Чтобы убрать компанию из назначенных: в правой секции выберите компанию и нажмите **Убрать из выбранных**, или нажмите **Убрать все** для очистки. |
| - | |
| - | 11. Нажмите **Создать слой**. |
| - | |
| - | Слой сохранён. |
| - | |
| - | ### Редактировать существующий слой |
| - | |
| - |  |
| - | |
| - | 1. В таблице слоёв наведите курсор на нужную строку. |
| - | 2. Нажмите значок карандаша **Редактировать**. |
| - | 3. Внесите изменения в модальном окне (аналогично форме создания). |
| - | 4. Нажмите **Сохранить**. |
| - | |
| - | ### Удалить слой |
| - | |
| - | > ⚠️ Удаление слоя приводит к его исчезновению из всех компаний, которым он назначен. Операция необратима. |
| - | |
| - | 1. Наведите курсор на строку слоя → нажмите значок корзины **Удалить**. |
| - | |
| - | Или: отметьте несколько слоёв чекбоксами → нажмите кнопку **Удалить**, которая появится вместо кнопки «+ Добавить слой». |
| - | |
| - | 2. В модальном окне подтверждения будет указано, в каких компаниях используется слой. |
| - | 3. Нажмите **Удалить** для подтверждения или **Отменить** для отказа. |
| - | |
| - | ## Частые вопросы и ошибки |
| - | |
| - | **Система не принимает URL, хотя сервис доступен.** |
| - | Проверьте: |
| - | - URL начинается с `https://`, а не `http://` |
| - | - URL не содержит локальный адрес (localhost, IP из диапазона 192.168.x.x или 10.x.x.x) |
| - | - Длина URL не превышает 500 символов |
| - | - Тип WMS определяется по наличию `/wms` в URL перед строкой параметров. Убедитесь, что URL содержит `/wms` в пути. |
| - | |
| - | >**Слой не отображается при включённом VPN.** |
| - | WMS-сервисы (в особенности российские государственные — НСПД, Росреестр) могут блокировать запросы с иностранных IP-адресов. Если слой перестал работать или не работает с момента создания — отключите VPN и проверьте снова. |
| - | |
| - | >**Сервис не открывается или выдаёт ошибку сертификата.** |
| - | Ряд российских государственных картографических сервисов использует сертификаты, выданные Минцифры России. Эти сертификаты не входят в стандартное хранилище доверенных центров сертификации браузеров Chrome и Firefox, из-за чего браузер блокирует соединение. |
| - | **Решение:** откройте URL сервиса в **Яндекс Браузере** — он поддерживает сертификаты Минцифры России по умолчанию. После успешного открытия скопируйте полный Request URL из DevTools и используйте его для создания слоя в SKIF.PRO. |
| - | |
| - | >**Слой создан, но администратор компании не видит его в настройках.** |
| - | Убедитесь, что компания добавлена в правую секцию **Присутствует в компаниях** при создании слоя. Если компания не назначена — слой будет создан, но недоступен ни одной компании. Отредактируйте слой и добавьте компанию. |
| - | |
| - | >**Статус проверки доступности — ошибка.** |
| - | Система выполняет HEAD-запрос к URL слоя при сохранении. Допустимые статусы ответа: 200 и 400 (WMS-сервисы часто возвращают 400 при запросе без обязательных параметров). Если ошибка сохраняется — проверьте, что сервис доступен из сети платформы и возвращает заголовок `Access-Control-Allow-Origin`. |
| документация для интеграторов/ресурсы компании/слои/как создать wms-слой в админ-панели/wms-admin-sloi.webp .. /dev/null | |
| документация для интеграторов/ресурсы компании/слои/как создать wms-слой в админ-панели/wms_admin-2.webp .. /dev/null | |
| документация для интеграторов/ресурсы компании/слои/как создать wms-слой в админ-панели/wms_admin-3.webp .. /dev/null | |
| руководство пользователя/карта.md .. /dev/null | |
| @@ 1,13 0,0 @@ | |
| - | --- |
| - | page_role: hub |
| - | audience: R1 |
| - | section: "Карта" |
| - | --- |
| - | |
| - | # Карта |
| - | |
| - | Раздел «Карта» описывает работу с интерактивной картой в SKIF.PRO: отображение объектов мониторинга в реальном времени, управление картографическими слоями и просмотр маршрутов движения транспорта. |
| - | |
| - | ## Подразделы |
| - | |
| - | - [Картографические слои](Картографические-слои) — наложение дополнительных карт поверх основной: кадастр, погодные данные, отраслевые ГИС-слои |
| руководство пользователя/карта/картографические слои.md .. /dev/null | |
| @@ 1,49 0,0 @@ | |
| - | --- |
| - | type: B |
| - | source: S2 |
| - | audience: R1 |
| - | section: Карта/Картографические слои |
| - | owner: [Панасюк Кирилл Юрьевич] |
| - | last_verified: 2025-06-01 |
| - | tested_by: не требуется (концепция) |
| - | version: [release 05.03.2026] |
| - | --- |
| - | |
| - | # Что такое картографические слои в SKIF.PRO |
| - | |
| - | |
| - | ## Для чего это нужно |
| - | |
| - | Стандартная карта в SKIF.PRO показывает дороги, здания и спутниковые снимки. Иногда для работы нужна дополнительная информация прямо поверх карты — например, границы земельных участков из кадастра, зоны ограничения скорости или данные о погоде. |
| - | |
| - | Картографические слои позволяют наложить на основную карту любую из таких дополнительных карт. Слои можно включать и выключать в любой момент, не меняя основной вид карты. |
| - | |
| - | ## Как это работает |
| - |  |
| - | |
| - | Слой — это полупрозрачное изображение, которое накладывается поверх основной карты. Слои загружаются из внешних картографических сервисов по технологии WMS (Web Map Service) — стандартному формату для обмена картами между системами. |
| - | |
| - | Когда вы включаете слой, SKIF.PRO запрашивает актуальное изображение у источника слоя и отображает его на карте. Данные в слое обновляются при каждом открытии — они всегда актуальны на момент просмотра. |
| - | |
| - |  |
| - | |
| - | Порядок слоёв имеет значение: слой, стоящий первым в списке, отображается поверх остальных. Порядок настраивается в разделе **Настройки отображения → Карта → Слои**. |
| - | |
| - | ## Сценарии применения |
| - | |
| - | **Кадастровая карта.** Водитель или диспетчер видит на карте границы земельных участков и может соотнести маршрут с кадастровыми данными. Подключается через слой Росреестра или НСПД. |
| - | |
| - | **Зоны ограничения скорости.** Администратор подключает слой с дорожными ограничениями, чтобы операторы видели, где нужно особое внимание при мониторинге. |
| - | |
| - | **Отраслевые ГИС-данные.** Компании с собственными ГИС-системами могут подключить корпоративные слои — например, схемы нефтепроводов, зоны доставки или территории обслуживания. |
| - | |
| - | **Погода и условия дороги.** Подключение внешних метеорологических слоёв для планирования маршрутов с учётом погодных условий. |
| - | |
| - | ## Ограничения и важные условия |
| - | |
| - | - Слои подключаются только через защищённый протокол **https://**. Адреса, начинающиеся с http://, не поддерживаются. |
| - | - Слои, доступные в вашей компании, настраивает администратор. Если нужного слоя нет в списке — обратитесь к администратору вашей компании или в техническую поддержку. |
| - | - Отображение слоёв зависит от доступности внешнего сервиса. Если источник слоя недоступен, слой не появится на карте. |
| - | - Количество одновременно активных слоёв может влиять на скорость загрузки карты. |
| - | |
| - | [**Как создать WMS-слой в Админ-панели**](Документация для интеграторов/Ресурсы компании/Слои/Как создать WMS-слой в Админ-панели.md) |
| руководство пользователя/карта/картографические слои/map-6.webp .. /dev/null | |
| руководство пользователя/карта/картографические слои/map-7.webp .. /dev/null | |
