Commit e35284
2026-03-10 12:23:38 GitLab Deploy: cleanup: remove all test content| Документация для интеграторов/Карта/Картографические слои/Как создать WMS-слой в Админ-панели.md .. /dev/null | |
| @@ 1,138 0,0 @@ | |
| - | --- |
| - | 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`. |
| - | |
| - | ## Что дальше |
| - | |
| - | - Описание всех полей и элементов интерфейса раздела «Слои» — см. статью «Раздел "Слои" в Ресурсах компании: описание интерфейса» |
| - | - Как администраторы компаний активируют слои — см. статью «Как активировать картографические слои для компании» |
| - | |
| - | > 📱 Статья для пользователей: [Как включить картографический слой на карте](ссылка) |
| Руководство пользователя/Карта/Картографические слои/Что такое картографические слои в 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 |
| руководство пользователя.md .. /dev/null | |
| @@ 1,1 0,0 @@ | |
| - | # Руководство пользователя |
| руководство пользователя/карта.md .. /dev/null | |
| @@ 1,1 0,0 @@ | |
| - | # Карта |
| руководство пользователя/карта/картографические слои.md .. /dev/null | |
| @@ 1,1 0,0 @@ | |
| - | # Картографические слои |
| руководство пользователя/карта/картографические слои/что такое слои.md .. /dev/null | |
| @@ 1,3 0,0 @@ | |
| - | # Тестовая статья |
| - | |
| - | Контент статьи. |