Mapflow <> QGIS
Внимание
Mapflow можно использовать через QGIS. Необходимо пройти авторизацию для работы с Mapflow API и получить API-токен для входа в систему.
QGIS – ГИС с открытым исходным кодом
QGIS (qgis.org) — ведущая и самая популярная настольная ГИС с открытым исходным кодом. Пользователи могут визуализировать, управлять, редактировать, анализировать геоданные и составлять карты для печати. Узнайте больше о QGIS и установите программу через официальный сайт.
QGIS имеет интерфейс для внешних плагинов Python, который позволяет подключать больше приложений и расширять основные функциональные возможности. Наше приложение «Mapflow — QGIS» позволяет подключаться к Mapflow Mapflow processing API, чтобы запускать AI-картографические обработки и добавлять выходные результаты в виде слоев в рабочее пространство QGIS.
Как установить плагин
Нажмите Плагины –> Управление…, перейдите на вкладку Не установлены (или Все) и введите «Mapflow» в поле поиска. Нажмите Установить плагин. Затем вы сможете увидеть, доступна ли более новая версия приложения (на вкладке Upgradeable), и проверить подробности в журнале изменений.
Значок плагина появился на панели инструментов QGIS. Если значок не отображается автоматически, щелкните правой кнопкой мыши на панели инструментов и проверьте, установлен ли флажок Mapflow.
Вход и авторизация
Вам необходимо войти в систему с вашими учетными данными, чтобы начать использовать плагин. Перейдите на mapflow.ai, зарегистрируйтесь и получите токен API.
Или вы можете воспользоваться протоколом OAuth 2.0, как более удобным и безопасным способом.
Предупреждение
Вход в систему с помощью OAuth - удобная функция, но для нас она все еще остается экспериментальной.
Также имейте в виду, что на данный момент эта функция не поддерживает прокси-серверы.
Настройка OAuth2
Информацию о том, как войти в систему с помощью OAuth, можно найти в этой секции.
Пользовательский интерфейс
Основное рабочее пространство плагина состоит из двух разделов: левой боковой панели с элементами управления обработкой и раздела вкладок.
Панель управления обработкой позволяет начать новую обработку и/или оценить законченную обработку и включает в себя следующее:
Панель запуска обработки
Имя поля / элемента |
Описание |
---|---|
Имя обработки |
Задайте имя обработки |
Область |
Область обработки. Этот слой автоматически отображается в выпадающем списке из списка векторных слоев QGIS. |
Источник данных |
Базовые изображения для обработки. По умолчанию выбран Mapbox, в выпадающем списке также можно выбрать спутниковые снимки коммерческих поставщиков. Вы можете открыть свое изображение через кнопку дополнительных опций. |
Показать превью |
Предварительный просмотр вашего источника данных или, если он недоступен, базовая подложка OpenStreetMap |
Использовать экстент изображения |
Эта область становится активной, если выполняется обработка файла .tif. Позволяет не создавать для данного изображения дополнительную область обработки векторного слоя, а берет ее экстент. |
Площадь области обработки |
Автоматический расчет площади по области обработки. |
Модель ИИ |
Тип обработки. В выпадающем списке вы можете выбрать следующие типы обработки (список сценариев обработки по умолчанию): Распознавание зданий, Распознавание дорог, Распознавание леса, Распознавание леса с высотами, Распознавание строительства, Распознавание полей. |
Ваш баланс |
Лимит площади, доступный для обработки |
Начать обработку |
Кнопка запуска обработки. После нажатия на нее вы увидите уведомление об успешном начале обработки, либо о неверно выбранных параметрах. Ообработка появится в списке обработок после успешного запуска. |
Рейтинг |
Оценка выполненной обработки |
Форма обратной связи |
Комментарии по поводу оценки |
Ваш текущий баланс отображается на панели инструментов. Он также содержит меню для доступа к вашему личному профилю на Mapflow.ai: пополнить баланс; открыть историю платежей; выйти из текущего сеанса.
Панель содержит 4 вкладки:
1. Обработка
Пояснения к полям и кнопкам на этой вкладке:
Название поля |
Описание |
---|---|
Название |
Название вашей обработки. |
Модель |
Выбранная модель ИИ из списка доступных. |
Статус |
Статус обработки: IN_PROGRESS, OK, FAILED. |
Прогресс |
Процент выполненной обработки. |
Область |
Область обработки (AOI). |
Дата |
Дата-время создания обработки. |
Название кнопки |
Описание |
---|---|
Просмотр результатов |
Показывает результаты завершенной обработки в слоях QGIS. |
Удалить |
Удаляет выбранную обработку/обработки. |
Опции |
Список опций для работы с результатами обработок. |
Сохранить результаты |
Сохраняет результаты обработки в файле GeoJSON. |
Скачать область интереса |
Добавляет AOI обработки в qgis в виде слоя для дальнейшей работы или экспорта. |
Подробности |
Отображает информацию об обработке (Название, Статус, Модель, Параметры модели, Источник данных). |
Переименовать |
Переименовывает вашу обработку. |
Подсказка
Для загрузки результатов обработки можно дважды щелкнуть по выполненной обработке в списке
2. Поиск снимков
Имя поля / элемента |
Описание |
---|---|
«Редактирование» |
Редаактирование параметров провайдеров. |
Просмотр |
Превью выбранного провайдера - добавляет слой на карту QGIS. |
ID снимка |
Идентификатор изображения из Каталога изображений указанного источника изображений. |
Макс зум |
Число Zoom выбрано по умолчанию, чтобы исключить потребление платного трафика для предварительного просмотра (актуально при подключении к Maxar SecureWatch). |
Область |
Область поиска метаданных спутниковой съемки. |
Использовать охват карты |
Область обработки будет создана из экстента рабочего окна QGIS. |
Интервал дат (От…До) |
Изображения будут найдены в рамках указанного периода времени. |
Искать снимки |
Скачивает метаданные снимков по выбранной области. Показывается лист найденных изображений, пересекающихся с AOI. |
Дополнительные фильтры |
Используйте для установки минимальной степени пересечения между изображением и интересующей областью и минимального процента облачности изображения. |
Подсказка
Вы можете задать свой собственный источник данных в формате XYZ. Вот пример: https://your_site.xyz/{z}/{x}/{y}
Подсказка
Узнайте как подключиться к бесплатным источникам изображений – например OpenAerialMap
Узнайте как подключиться к Maxar Imagery
3. Настройки
Имя поля / элемента |
Описание |
---|---|
Провайдеры |
Выпадающий список с дополнительными провайдерами спутниковых снимков. |
«Добавить источник» |
Кнопка добавления провайдера даннных. |
«Удалить источник» |
Кнопка удаления провайдера даннных. |
«Редактирование источника» |
Открывает диалоговое окно для добавления пользовательского источника данных. |
Выбор проекта mapflow |
Выпадающий список с проектами mapflow в вашем аккаунте. |
«Добавить проект» |
Кнопка создания вашего нового mapflow проекта. |
«Удалить проект» |
Кнопка удаления mapflow проекта. |
«Редактирование проекта» |
Кнопка редактирования mapflow проекта. |
Здесь вы можете настроить, как результаты обработки будут загружаться в QGIS. Есть два способа:
просмотр результатов в виде векторного слоя
- это потоковая передача векторных фрагментов непосредственно с нашего сервера, которая позволяет просматривать результаты обработки без загрузки полного файла результатов, что ускоряет работу с большими обработками.сохранять локальный файл gpkg для просмотра результатов
- Сохранение локальных файлов pkg на вашем диске для дальнейшей загрузки в виде слоев QGIS.
Предупреждение
Векторные плитки - это экспериментальная функция для нас, поэтому выбирайте тот способ, который вам удобен.
Подсказка
Эта вкладка также содержит ссылку на «Рабочую папку».
Рабочая папка - укажите, куда будут загружаться результаты обработки на ваш локальный диск если выбрана опция сохранять локальный файл gpkg для просмотра результатов
.
4. Помощь
Вкладка содержит все полезные ссылки на документацию плагина.
Как запускать обработку
Для запуска обработки выберите или создайте полигон (AOI).
Плагин имеет несколько встроенных опций для создания AOI.
Создать новую область (AOI) из экстента карты с помощью кнопки «+»;
Загрузите существующую область с помощью кнопки «+»;
Нарисовать AOI на карте;
Используйте экстент загруженного изображения.
Кроме того, вы можете создать новый векторный слой или добавить существующий AOI в проект QGIS. Если векторный слой состоит из нескольких полигонов, выберите один из них.
Использование коммерческих провайдеров спутниковых снимков
Как подключиться к Maxar SecureWatch
Примечание
SecureWatch — это сервис, который обеспечивает глобальный доступ к спутниковым изображениям высокого разрешения и базовым мозаикам изображений от мирового лидера в области дистанционного зондирования MAXAR по модели подписки. Пространственное разрешение изображений варьируется в диапазоне от 30 см до 1 м. Все изображения сопровождаются метаданными, включая информацию о дате и времени получения, облачности и т. д. В приложении реализован специальный интерфейс для подключения к этому сервису и использования изображений через конвейеры обработки Mapflow.
Использование встроенного доступа Maxar SecureWatch для обработки изображений с помощью Mapflow
В раскрывающемся списке Источник данных выберите нужный продукт Maxar (SecureWatch, Vivid), перейдите на вкладку Поиск снимков.
Превью и выбор снимка Maxar
Убедитесь что вы указали AOI в списке меню «Область» или в охвате экрана и другие параметры поиска и нажмите Поиск снимков.
Дважды щелкните выбранное изображение в результатах поиска (или нажмите кнопку Просмотр), чтобы добавить его на карту.
Важно
В бесплатном тарифном плане Максимальный зум ограничен до 12 и запуск обработки через SecureWatch невозможен. Если вы хотите использовать этого поставщика данных - вам необходимо перейти на тарифный план «Премиум <https://mapflow.ai/pricing>`_ или написать нам <https://geoalert.io/#contacts> _ чтобы узнать цену.
Использование вашего собственного аккаунта SecureWatch для обработки изображений с помощью Mapflow
Нажмите кнопку + и выберите в выпадающем списке опцию Maxar WMTS;
Введите Логин/Пароль от вашей учетной записи Maxar SecureWatch;
Введите URL-ссылку WMTS для Maxar Secure Watch (SecureWatch — Login - Securewatch - Use with - Web Services - WMTS)
Необязательно: укажите систему координат (по умолчанию epsg:3857);
Необязательно: Отметьте Сохранить логин и пароль
Подсказка
Как найти ссылку на Maxar WMTS:
Перейдите на SecureWatch и войдите под вашей учетной записью.
В верхнем меню выберите Use With >> Web Services >> WMTS
Скопируйте WMTS (или TMS) url.
Connect ID различается для каждого продукта, включенного в вашу подписку SecureWatch. Поэтому изначально выбирайте тот, который вам нужен. Для этого откройте меню Профиль пользователя и в строке заголовка выберите нужный из предложенных продуктов (Vivid или SecureWatch, etc).
Нажмите «Просмотр».
Теперь слой Maxar доступен для предварительного просмотра в списке растровых слоев и для картографической AI обработки с помощью Mapflow.
Как найти и обработать изображение по Feature ID с помощью Maxar SecureWatch
Вы можете использовать SW, чтобы найти доступные изображения для интересующей вас области.
Перейдите во вкладку Поиск снимков.
Выберите Maxar SecureWatch в выпадающем списке.
В Каталоге изображений Maxar SecureWatch выберите векторный слой, содержащий границу интересующей вас области.
Примечание
Чтобы определить область поиска изображения, вы можете создать новый полигон (Слой -> Создать слой -> …, выбрать Многоугольник в качестве типа геометрии, добавить полигон с помощью инструмента Добавить объект полигона) или загрузить его из файл с координатами. Если в файле более одного полигона, выберите инструментом Выбрать объект(ы) нужный полигон. Для получения дополнительной информации о создании и работе с векторными слоями см. Руководство пользователя QGIS. Кроме того, вы можете установить флажок «создать из видимой области карты».
Выполните поиск изображений, чтобы просмотреть метаданные всех доступных изображений, пересекающих вашу область интереса. Вы можете применить поисковые фильтры и указать период, за который вы хотели бы получать изображения. Это поможет в формировании каталога снимков с необходимыми параметрами.
Выберите предпочтительное изображение из каталога изображений или используйте сгенерированный WFS векторный слой (метаданные Maxar SW) для поиска по дополнительным атрибутам. Если вы хотите заранее обработать определенное изображение, вставьте свой идентификатор изображения в поле ID снимка, это облегчит поиск изображения в каталоге изображений.
Примечание
Метаданные изображения сохраняются в виде векторного слоя. Вы можете использовать дополнительный поиск по его таблицей атрибутов.
Нажмите Предварительный просмотр, чтобы просмотреть выбранное изображение в виде нового растрового слоя (или двойной щелчок по строке в таблице).
Внимание
Флажок «max zoom 12» активен для предотвращения платного трафика на стороне Maxar SecureWatch.
Как использовать другие источники данных
Заходим в плагин, на вкладке Провайдеры нажимаем кнопку Добавить (1) и в открывшемся окне вводим соответствующие данные (2). Нажмите Просмотр (3) изображения, - вы должны быть в правильном масштабе и координатах, чтобы увидеть изображение.
Чтобы начать обработку с использованием этого источника данных, перейдите на вкладку Обработка, заполните все поля параметров обработки, нажмите Начать обработку.
Имя поля / элемента |
Описание |
---|---|
Название |
Название нового провайдера данных |
URL |
URL дата провайдера |
Тип |
Тип источника данных. Вы можете ввести собственный URL-адрес источника изображений в одном из следующих форматов: XYZ, TMS, WMS, Quadkey. Все форматы представляют собой наиболее широко используемые протоколы для получения изображений с географической привязкой через HTTP. |
Подсказка
Проверьте, есть ли дополнительные подключения к источникам изображений в UserGuide How To:
Как подключиться к Openaerialmap
Как подключиться к Nearmap
Как загрузить свое изображение
Вы можете загрузить свой собственный геотифф. Все растровые слои, загруженные в данный момент в ваш QGIS (1), отображаются в раскрывающемся списке (2) и могут быть выбраны для загрузки.
Важно
Пожалуйста, соблюдайте требования, указанные на странице с Требования к использованию платформы, при загрузке собственных изображений для обработки через API платформы Mapflow.
- Проверяет тип данных
Тип данных должен быть байтовым (8 бит). Если тип данных Int16 или Float32 и т. д., следуйте инструкциям Userguides - How To 🙋♂️. Альтернативный вариант: используйте скрипт предварительной обработки
- Проверяет размеры изображения
Размер изображения с обеих сторон не должен превышать 30 000x30 000 пикселей. Если у вас есть изображения большего размера, вы должны либо разрезать их на более мелкие фрагменты, либо переключиться на Mapflow custom.
- Проверяет кол-во каналов изображения
Обычно Mapflow обрабатывает 3-канальные изображения RGB. Платформа Mapflow также может обрабатывать одноканальные (панхроматические) изображения, но модели ИИ не настроены на такие данные, поэтому качество результата может быть хуже ожидаемого.
- Проверяет проекцию и географическую привязку
Убедитесь, что ваши изображения имеют географическую привязку в географической или проекционной системе координат.
- Проверяет разрешение изображения
Ограничения по разрешению различаются для разных моделей, см. Требования моделей
Вы можете отправить запрос на предобработку данных на help@geoalert.io
Работа с результатами
Просмотр результатов
Результаты обработки, завершенные на 100% можно загрузить в виде векторного файла в локальный каталог и автоматически добавить в качестве слоя в рабочее пространство QGIS.
Дважды щелкните имя обработки в таблице 1. Обработка или выберите ее и нажмите кнопку «Просмотр результатов». Слой появится на панели «Слои» (QGIS –> Вид –> Панели –> Слои) в папке «Mapflow». Дальше с ним можно работать как с обычным векторным слоем в QGIS.
Примечание
Если используется модель AI по умолчанию, плагин автоматически добавляет стили векторному слою. Для всех пользовательских моделей/сценариев назначается единый стиль по умолчанию. Вы всегда можете изменить стили.
Сохранить результаты
Результаты обработки, которые завершены на 100%, можно загрузить в формате GeoJSON, для этого нажмите на кнопку Сохранить результаты
, в появившемся окне выберите выходной каталог и назовите файл для сохранения.
Удалить обработку
Чтобы удалить обработку - выберите ее в списке, нажмите кнопку «Удалить» и подтвердите.
Предупреждение
Удаленная обработка не может быть восстановлена пользователем. Перед окончательным удалением резервная копия данных временно сохраняется на сервере Mapflow на случай чрезвычайной ситуации. Так что, если вы удалили свои результаты по ошибке и хотите, чтобы мы восстановили обработку — отправьте запрос в поддержку без промедления.
Валидация результатов
Примечание
❗️ Эта опция доступна для ограниченного числа клиентов Mapflow, которые подписались на корпоративную поддержку
Если активировано, каждая завершенная обработка получает статус «Review required». Пользователь может либо принять результат, либо запросить проверку, чтобы служба поддержки могла повторно обработать его и получить лучшие результаты, пока результат не будет соответствовать требованиям. Чтобы запросить Review результатов:
Выберите обработку в статусе «Review required» и нажмите кнопку «Review»
Добавьте комментарии для пояснения:
Добавьте комментарии зачем и по каким критериям вы запрашиваете валидацию результатов
Опционально Добавьте область полигона, выделяя объекты, которые неправильно обработаны, неправильно идентифицированы и т. д. – это поможет нам обратить внимание на конкретные проблемы
Стату обработки сменится на «In review»
Как только проверка будет завершена с нашей стороны, статус снова изменится на «Review required». Примите результаты или вернитесь к #1
Настройки прокси
Если вы находитесь за брандмауэром, перейдите в QGIS -> Настройки -> Сеть и настройте параметры прокси для подключения плагина.