Commit 5c26c3
2026-03-10 12:11:43 GitLab Deploy: sync: deploy from GitLab CI — 2026-03-10 12:11 UTC| /dev/null .. Документация для интеграторов/Карта/Картографические слои/Как создать WMS-слой в Админ-панели.md | |
| @@ 0,0 1,138 @@ | |
| + | --- |
| + | type: A |
| + | source: S2 |
| + | audience: R2 |
| + | section: Карта/Картографические слои |
| + | owner: [Панасюк Кирилл Юрьевич] |
| + | last_verified: 2025-06-01 |
| + | tested_by: [⚠️ ЗАПОЛНИТЬ: имя тестировщика — обязательно до публикации] |
| + | 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 символов |
| + | |
| + | **Слой не отображается при включённом VPN.** |
| + | WMS-сервисы (в особенности российские государственные — НСПД, Росреестр) могут блокировать запросы с иностранных IP-адресов. Если слой перестал работать или не работает с момента создания — отключите VPN и проверьте снова. |
| + | |
| + | **Сервис не открывается или выдаёт ошибку сертификата.** |
| + | Ряд российских государственных картографических сервисов использует сертификаты, выданные Минцифры России. Эти сертификаты не входят в стандартное хранилище доверенных центров сертификации браузеров Chrome и Firefox, из-за чего браузер блокирует соединение. |
| + | |
| + | Решение: откройте URL сервиса в **Яндекс Браузере** — он поддерживает сертификаты Минцифры России по умолчанию. После успешного открытия скопируйте полный Request URL из DevTools и используйте его для создания слоя в SKIF.PRO. |
| + | |
| + | |
| + | Тип WMS определяется по наличию `/wms` в URL перед строкой параметров. Убедитесь, что URL содержит `/wms` в пути. [⚠️ УТОЧНИТЬ у S3: что происходит, если тип не определяется — можно ли указать тип вручную?] |
| + | |
| + | **Слой создан, но администратор компании не видит его в настройках.** |
| + | Убедитесь, что компания добавлена в правую секцию **Присутствует в компаниях** при создании слоя. Если компания не назначена — слой будет создан, но недоступен ни одной компании. Отредактируйте слой и добавьте компанию. |
| + | |
| + | **Статус проверки доступности — ошибка.** |
| + | Система выполняет HEAD-запрос к URL слоя при сохранении. Допустимые статусы ответа: 200 и 400 (WMS-сервисы часто возвращают 400 при запросе без обязательных параметров). Если ошибка сохраняется — проверьте, что сервис доступен из сети платформы и возвращает заголовок `Access-Control-Allow-Origin`. |
| + | |
| + | ## Что дальше |
| + | |
| + | - Описание всех полей и элементов интерфейса раздела «Слои» — см. статью «Раздел "Слои" в Ресурсах компании: описание интерфейса» |
| + | - Как администраторы компаний активируют слои — см. статью «Как активировать картографические слои для компании» |
| + | |
| + | > 📱 Статья для пользователей: [Как включить картографический слой на карте](ссылка) |
| /dev/null .. Руководство пользователя/Карта/Картографические слои/Что такое картографические слои в SKIF.PRO.md | |
| @@ 0,0 1,48 @@ | |
| + | --- |
| + | 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 |