Commit 4a3ca1
2026-03-11 12:03:27 GitLab Deploy: sync: deploy from GitLab commit 9dbd0662| документация для интеграторов/карта.md .. /dev/null | |
| @@ 1,1 0,0 @@ | |
| - | # Карта |
| документация для интеграторов/карта/картографические слои.md .. /dev/null | |
| @@ 1,1 0,0 @@ | |
| - | # Картографические слои |
| документация для интеграторов/карта/картографические слои/как создать wms-слой в админ-панели/wms-admin-sloi.webp .. /dev/null | |
| /dev/null .. документация для интеграторов/ресурсы компании.md | |
| @@ 0,0 1,13 @@ | |
| + | --- |
| + | page_role: hub |
| + | audience: R2 |
| + | section: "Ресурсы компании" |
| + | --- |
| + | |
| + | # Ресурсы компании |
| + | |
| + | Раздел описывает управление ресурсами компании в Админ-панели SKIF.PRO: картографические слои, а также другие подразделы, доступные интегратору для настройки платформы. |
| + | |
| + | ## Подразделы |
| + | |
| + | - [Слои](Ресурсы-компании/Слои) — создание, настройка и управление WMS-слоями через Админ-панель |
| /dev/null .. документация для интеграторов/ресурсы компании/слои.md | |
| @@ 0,0 1,42 @@ | |
| + | --- |
| + | 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](/Руководство-пользователя/Карта/Картографические-слои) — статья для конечных пользователей |
| документация для интеграторов/карта/картографические слои/как создать wms-слой в админ-панели.md .. документация для интеграторов/ресурсы компании/слои/как создать wms-слой в админ-панели.md | |
| @@ 2,7 2,7 @@ | |
| type: A | |
| source: S2 | |
| audience: R2 | |
| - | section: Карта/Картографические слои |
| + | section: Ресурсы компании/Слои |
| owner: [Панасюк Кирилл Юрьевич] | |
| last_verified: 2025-06-01 | |
| tested_by: "Dmitriy Obrazumov" | |
| @@ 11,7 11,7 @@ | |
| # Как создать WMS-слой в Админ-панели | |
| - |  |
| + |  |
| ## Когда это нужно | |
| @@ 37,6 37,8 @@ | |
| ## Пошаговая инструкция | |
| + |  |
| + | |
| ### Открыть раздел управления слоями | |
| 1. Войдите в **Админ-панель** SKIF.PRO. | |
| @@ 87,10 89,12 @@ | |
| 11. Нажмите **Создать слой**. | |
| - | Слой сохранён. Администраторы назначенных компаний увидят его в разделе **Компании → Настроить → Слои** и смогут активировать его для операторов. |
| + | Слой сохранён. |
| ### Редактировать существующий слой | |
| + |  |
| + | |
| 1. В таблице слоёв наведите курсор на нужную строку. | |
| 2. Нажмите значок карандаша **Редактировать**. | |
| 3. Внесите изменения в модальном окне (аналогично форме создания). | |
| @@ 101,7 105,7 @@ | |
| > ⚠️ Удаление слоя приводит к его исчезновению из всех компаний, которым он назначен. Операция необратима. | |
| 1. Наведите курсор на строку слоя → нажмите значок корзины **Удалить**. | |
| - | |
| + | |
| Или: отметьте несколько слоёв чекбоксами → нажмите кнопку **Удалить**, которая появится вместо кнопки «+ Добавить слой». | |
| 2. В модальном окне подтверждения будет указано, в каких компаниях используется слой. | |
| @@ 114,27 118,17 @@ | |
| - URL начинается с `https://`, а не `http://` | |
| - URL не содержит локальный адрес (localhost, IP из диапазона 192.168.x.x или 10.x.x.x) | |
| - Длина URL не превышает 500 символов | |
| + | - Тип WMS определяется по наличию `/wms` в URL перед строкой параметров. Убедитесь, что URL содержит `/wms` в пути. |
| - | **Слой не отображается при включённом VPN.** |
| + | >**Слой не отображается при включённом VPN.** |
| WMS-сервисы (в особенности российские государственные — НСПД, Росреестр) могут блокировать запросы с иностранных IP-адресов. Если слой перестал работать или не работает с момента создания — отключите VPN и проверьте снова. | |
| - | **Сервис не открывается или выдаёт ошибку сертификата.** |
| + | >**Сервис не открывается или выдаёт ошибку сертификата.** |
| Ряд российских государственных картографических сервисов использует сертификаты, выданные Минцифры России. Эти сертификаты не входят в стандартное хранилище доверенных центров сертификации браузеров Chrome и Firefox, из-за чего браузер блокирует соединение. | |
| + | **Решение:** откройте URL сервиса в **Яндекс Браузере** — он поддерживает сертификаты Минцифры России по умолчанию. После успешного открытия скопируйте полный Request URL из DevTools и используйте его для создания слоя в SKIF.PRO. |
| - | Решение: откройте URL сервиса в **Яндекс Браузере** — он поддерживает сертификаты Минцифры России по умолчанию. После успешного открытия скопируйте полный Request URL из DevTools и используйте его для создания слоя в SKIF.PRO. |
| - | |
| - | |
| - | Тип WMS определяется по наличию `/wms` в URL перед строкой параметров. Убедитесь, что URL содержит `/wms` в пути. [⚠️ УТОЧНИТЬ у S3: что происходит, если тип не определяется — можно ли указать тип вручную?] |
| - | |
| - | **Слой создан, но администратор компании не видит его в настройках.** |
| + | >**Слой создан, но администратор компании не видит его в настройках.** |
| Убедитесь, что компания добавлена в правую секцию **Присутствует в компаниях** при создании слоя. Если компания не назначена — слой будет создан, но недоступен ни одной компании. Отредактируйте слой и добавьте компанию. | |
| - | **Статус проверки доступности — ошибка.** |
| + | >**Статус проверки доступности — ошибка.** |
| Система выполняет HEAD-запрос к URL слоя при сохранении. Допустимые статусы ответа: 200 и 400 (WMS-сервисы часто возвращают 400 при запросе без обязательных параметров). Если ошибка сохраняется — проверьте, что сервис доступен из сети платформы и возвращает заголовок `Access-Control-Allow-Origin`. | |
| - | |
| - | ## Что дальше |
| - | |
| - | - Описание всех полей и элементов интерфейса раздела «Слои» — см. статью «Раздел "Слои" в Ресурсах компании: описание интерфейса» |
| - | - Как администраторы компаний активируют слои — см. статью «Как активировать картографические слои для компании» |
| - | |
| - | > 📱 Статья для пользователей: [Как включить картографический слой на карте](ссылка) |
| руководство пользователя/карта.md .. | |
| @@ 1,1 1,13 @@ | |
| + | --- |
| + | page_role: hub |
| + | audience: R1 |
| + | section: "Карта" |
| + | --- |
| + | |
| # Карта | |
| + | |
| + | Раздел «Карта» описывает работу с интерактивной картой в SKIF.PRO: отображение объектов мониторинга в реальном времени, управление картографическими слоями и просмотр маршрутов движения транспорта. |
| + | |
| + | ## Подразделы |
| + | |
| + | - [Картографические слои](Картографические-слои) — наложение дополнительных карт поверх основной: кадастр, погодные данные, отраслевые ГИС-слои |
| руководство пользователя/карта/картографические слои.md .. | |
| @@ 1,1 1,49 @@ | |
| - | # Картографические слои |
| + | --- |
| + | 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) |
| руководство пользователя/карта/картографические слои/что такое картографические слои в skif pro.md .. /dev/null | |
| @@ 1,48 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://, не поддерживаются. |
| - | - Слои, доступные в вашей компании, настраивает администратор. Если нужного слоя нет в списке — обратитесь к администратору вашей компании или в техническую поддержку. |
| - | - Отображение слоёв зависит от доступности внешнего сервиса. Если источник слоя недоступен, слой не появится на карте. |
| - | - Количество одновременно активных слоёв может влиять на скорость загрузки карты. |
| - | |
| - | ## Связанные инструкции |
| - | |
| - | - см. статью «Как включить картографический слой на карте» |
| - | - см. статью «Как активировать слои для компании» |
| \ | No newline at end of file |
