Mapflow <> QGIS

Внимание

Mapflow можно использовать через QGIS. Необходимо пройти авторизацию для работы с Mapflow API и получить API-токен для входа в систему.

Примечание

Просмотр результатов

Присоединяйтесь к Mapflow <> QGIS open source project on Github.

QGIS – ГИС с открытым исходным кодом

QGIS (qgis.org) — ведущая и самая популярная настольная ГИС с открытым исходным кодом. Пользователи могут визуализировать, управлять, редактировать, анализировать геоданные и составлять карты для печати. Узнайте больше о QGIS и установите программу через официальный сайт.

QGIS имеет интерфейс для внешних плагинов Python, который позволяет подключать больше приложений и расширять основные функциональные возможности. Наше приложение «Mapflow — QGIS» позволяет подключаться к Mapflow Mapflow processing API, чтобы запускать AI-картографические обработки и добавлять выходные результаты в виде слоев в рабочее пространство QGIS.

Как установить плагин

Нажмите Плагины –> Управление…, перейдите на вкладку Не установлены (или Все) и введите «Mapflow» в поле поиска. Нажмите Установить плагин. Затем вы сможете увидеть, доступна ли более новая версия приложения (на вкладке Upgradeable), и проверить подробности в журнале изменений.

Значок плагина появился на панели инструментов QGIS. Если значок не отображается автоматически, щелкните правой кнопкой мыши на панели инструментов и проверьте, установлен ли флажок Mapflow.

Вход и авторизация

Вам необходимо войти в систему с вашими учетными данными, чтобы начать использовать плагин. Перейдите на mapflow.ai, зарегистрируйтесь и получите токен API.

Окно входа

Пользовательский интерфейс

Основное рабочее пространство плагина состоит из двух разделов: левой боковой панели с элементами управления обработкой и раздела вкладок.

Основное рабочее окно

Панель управления обработкой позволяет начать новую обработку и/или оценить законченную обработку и включает в себя следующее:

Панель запуска обработки

Имя поля / элемента

Описание

Имя обработки

Задайте имя обработки

Область

Область обработки. Этот слой автоматически отображается в выпадающем списке из списка векторных слоев QGIS.

Источник данных

Базовые изображения для обработки. По умолчанию выбран Mapbox, в выпадающем списке также можно выбрать спутниковые снимки коммерческих поставщиков. Вы можете открыть свое изображение через кнопку дополнительных опций.

Использовать экстент изображения

Эта область становится активной, если выполняется обработка файла .tif. Позволяет не создавать для данного изображения дополнительную область обработки векторного слоя, а берет ее экстент.

Площадь области обработки

Автоматический расчет площади по области обработки.

Модель ИИ

Тип обработки. В выпадающем списке вы можете выбрать следующие типы обработки (список сценариев обработки по умолчанию): Распознавание зданий, Распознавание дорог, Распознавание леса, Распознавание леса с высотами, Распознавание строительства, Распознавание полей.

Ваш баланс

Лимит площади, доступный для обработки

Начать обработку

Кнопка запуска обработки. После нажатия на нее вы увидите уведомление об успешном начале обработки, либо о неверно выбранных параметрах. Ообработка появится в списке обработок после успешного запуска.

Рейтинг

Оценка выполненной обработки

Форма обратной связи

Комментарии по поводу оценки

Ваш текущий баланс отображается на панели инструментов. Он также содержит меню для доступа к вашему личному профилю на Mapflow.ai: пополнить баланс; открыть историю платежей; выйти из текущего сеанса.

Панель содержит 4 вкладки:

1. Обработка

2. Поиск снимков

3. Настройки

4. Помощь

1. Обработка

Вид панели обработок

Пояснение к полям и кнопкам этой вкладки:

Поля

Имя поля

Описание

Название

Название вашей обработки.

Модель

Выбранная модель ИИ из списка доступных.

Статус

Статус обработки: IN_PROGRESS, OK, FAILED.

Прогресс

Процент выполненной обработки.

Область

Область обработки (AOI).

Дата

Дата-время создания обработки.

Кнопки

Имя кнопки

Описание

Просмотр результатов

Показывает результаты завершенной обработки в слоях QGIS.

Подробности

Показывает информацию об обработке (Имя, Статус, Модель, Опции, Источник данных).

Сохранить результаты

Сохраняет результаты обработки в GeoJSON файл.

Удалить

Удаляет выбранную обработку/обработки.

Подсказка

Для загрузки результатов обработки можно дважды щелкнуть по выполненной обработке в списке

3. Настройки

Вкладка Поиска снимков

Добавить или изменить провайдеров данных

Имя поля / элемента

Описание

Провайдеры

Выпадающий список с дополнительными провайдерами спутниковых снимков.

«Добавить»

Кнопка добавления провайдера даннных.

«Удалить»

Кнопка удаления провайдера даннных.

«Редактирование»

Открывает диалоговое окно для добавления пользовательского источника данных

Здесь вы можете настроить способ загрузки результатов обработок в QGIS. Есть два способа:

  1. просмотр результатов в виде векторного слоя - потоковая передача векторных тайлов напрямую с нашего сервера, что позволяет вам просматривать результаты обработок без скачивания всего файла результатов, так что это будет быстрее для больших обработок.

  2. сохранять локальный файл gpkg для просмотра результатов - Сохранение локальных gpkg файлов на ваш диск для дальнейшей загрузки в качестве слоев QGIS.

Предупреждение

Векторные тайлы - это экспериментальная функция для нас, поэтому выбирайте тот метод, который удобен именно вам.

Подсказка

Эта вкладка также содержит ссылку на «Рабочую папку».

Рабочая папка - укажите, куда будут загружаться результаты обработки на ваш локальный диск если выбрана опция сохранять локальный файл gpkg для просмотра результатов

4. Помощь

Вкладка содержит все полезные ссылки на документацию плагина.

Как запускать обработку

Для запуска обработки выберите или создайте полигон (AOI).

Плагин имеет несколько встроенных опций для создания AOI.

  1. Создать новую область (AOI) из экстента карты с помощью кнопки «+»;

  2. Загрузите существующую область с помощью кнопки «+»;

  3. Нарисовать AOI на карте;

  4. Используйте экстент загруженного изображения.

Кроме того, вы можете создать новый векторный слой или добавить существующий AOI в проект QGIS. Если векторный слой состоит из нескольких полигонов, выберите один из них.

Просмотр AOI

Использование коммерческих провайдеров спутниковых снимков

Как подключиться к Maxar SecureWatch

Примечание

SecureWatch — это сервис, который обеспечивает глобальный доступ к спутниковым изображениям высокого разрешения и базовым мозаикам изображений от мирового лидера в области дистанционного зондирования MAXAR по модели подписки. Пространственное разрешение изображений варьируется в диапазоне от 30 см до 1 м. Все изображения сопровождаются метаданными, включая информацию о дате и времени получения, облачности и т. д. В приложении реализован специальный интерфейс для подключения к этому сервису и использования изображений через конвейеры обработки Mapflow.

  • Использование встроенного доступа Maxar SecureWatch для обработки изображений с помощью Mapflow

    В раскрывающемся списке Источник данных выберите нужный продукт Maxar (SecureWatch, Vivid), перейдите на вкладку Поиск снимков.

  • Превью и выбор снимка Maxar

    1. Убедитесь что вы указали AOI в списке меню «Область» или в охвате экрана и другие параметры поиска и нажмите Поиск снимков.

    2. Дважды щелкните выбранное изображение в результатах поиска (или нажмите кнопку Просмотр), чтобы добавить его на карту.

Важно

В бесплатном тарифном плане Максимальный зум ограничен до 12 и запуск обработки через SecureWatch невозможен. Если вы хотите использовать этого поставщика данных - вам необходимо перейти на тарифный план «Премиум <https://mapflow.ai/pricing>`_ или написать нам <https://geoalert.io/#contacts> _ чтобы узнать цену.

  • Использование вашего собственного аккаунта SecureWatch для обработки изображений с помощью Mapflow

Вкладка Поиска снимков

  1. Нажмите кнопку + и выберите в выпадающем списке опцию Maxar WMTS;

  2. Введите Логин/Пароль от вашей учетной записи Maxar SecureWatch;

  3. Введите URL-ссылку WMTS для Maxar Secure Watch (SecureWatch — Login - Securewatch - Use with - Web Services - WMTS)

  4. Необязательно: укажите систему координат (по умолчанию epsg:3857);

  5. Необязательно: Отметьте Сохранить логин и пароль

Подсказка

Как найти ссылку на Maxar WMTS:

  1. Перейдите на SecureWatch и войдите под вашей учетной записью.

  2. В верхнем меню выберите Use With >> Web Services >> WMTS

  3. Скопируйте WMTS (или TMS) url.

Ваш профиль на SecureWatch

Connect ID различается для каждого продукта, включенного в вашу подписку SecureWatch. Поэтому изначально выбирайте тот, который вам нужен. Для этого откройте меню Профиль пользователя и в строке заголовка выберите нужный из предложенных продуктов (Vivid или SecureWatch, etc).

  1. Нажмите «Просмотр».

Теперь слой Maxar доступен для предварительного просмотра в списке растровых слоев и для картографической AI обработки с помощью Mapflow.

Как найти и обработать изображение по Feature ID с помощью Maxar SecureWatch

Вы можете использовать SW, чтобы найти доступные изображения для интересующей вас области.

  1. Перейдите во вкладку Поиск снимков.

  2. Выберите Maxar SecureWatch в выпадающем списке.

  3. В Каталоге изображений Maxar SecureWatch выберите векторный слой, содержащий границу интересующей вас области.

Примечание

Чтобы определить область поиска изображения, вы можете создать новый полигон (Слой -> Создать слой -> …, выбрать Многоугольник в качестве типа геометрии, добавить полигон с помощью инструмента Добавить объект полигона) или загрузить его из файл с координатами. Если в файле более одного полигона, выберите инструментом Выбрать объект(ы) нужный полигон. Для получения дополнительной информации о создании и работе с векторными слоями см. Руководство пользователя QGIS. Кроме того, вы можете установить флажок «создать из видимой области карты».

Получить определенное изображение из SW
  1. Выполните поиск изображений, чтобы просмотреть метаданные всех доступных изображений, пересекающих вашу область интереса. Вы можете применить поисковые фильтры и указать период, за который вы хотели бы получать изображения. Это поможет в формировании каталога снимков с необходимыми параметрами.

  2. Выберите предпочтительное изображение из каталога изображений или используйте сгенерированный WFS векторный слой (метаданные Maxar SW) для поиска по дополнительным атрибутам. Если вы хотите заранее обработать определенное изображение, вставьте свой идентификатор изображения в поле ID снимка, это облегчит поиск изображения в каталоге изображений.

Примечание

Метаданные изображения сохраняются в виде векторного слоя. Вы можете использовать дополнительный поиск по его таблицей атрибутов.

  1. Нажмите Предварительный просмотр, чтобы просмотреть выбранное изображение в виде нового растрового слоя (или двойной щелчок по строке в таблице).

Внимание

Флажок «max zoom 12» активен для предотвращения платного трафика на стороне Maxar SecureWatch.

Как использовать другие источники данных

Например, так возможно использовать OpenAerialMap — это открытая коллекция данных изображений с БПЛА, собранная пользователями. Проект поддерживается консорциумом компаний, разрабатывающих ПО с открытым исходным кодом и сервисы для работы с пространственными данными. Как только ваш аэрофотоснимок публикуется на Openaerialmap, он отображается на общедоступной карте и может быть загружен с использованием протоколов TMS/WMTS.

Выберите изображение и скопируйте ссылку в TMS.

Поиск изображений в OpenAerialMap

Заходим в плагин, на вкладке Провайдеры нажимаем кнопку Добавить (1) и в открывшемся окне вводим соответствующие данные (2). Нажмите Просмотр (3) изображения, - вы должны быть в правильном масштабе и координатах, чтобы увидеть изображение.

Чтобы начать обработку с использованием этого источника данных, перейдите на вкладку Обработка, заполните все поля параметров обработки, нажмите Начать обработку.

Пользовательский источник данных

Имя поля / элемента

Описание

Название

Название нового провайдера данных

URL

URL дата провайдера

Тип

Тип источника данных. Вы можете ввести собственный URL-адрес источника изображений в одном из следующих форматов: XYZ, TMS, WMS, Quadkey. Все форматы представляют собой наиболее широко используемые протоколы для получения изображений с географической привязкой через HTTP.

Как загрузить свое изображение

Вы можете загрузить свой собственный файл GeoTIFF. Все растровые слои, загруженные в данный момент в QGIS (1), отображаются в раскрывающемся списке (2) и могут быть выбраны для загрузки.

Загрузить TIF, выберите из списка

Важно

Пожалуйста, соблюдайте требования, указанные на странице с Требования к использованию платформы, при загрузке собственных изображений для обработки через API платформы Mapflow.

  • Проверяет тип данных

    Тип данных должен быть байтовым (8 бит). Если тип данных Int16 или Float32 и т. д., следуйте инструкциям Userguides - How To. Альтернативный вариант: используйте скрипт предварительной обработки

  • Проверяет размеры изображения

    Размер изображения с обеих сторон не должен превышать 30 000x30 000 пикселей. Если у вас есть изображения большего размера, вы должны либо разрезать их на более мелкие фрагменты, либо переключиться на Mapflow custom.

  • Проверяет кол-во каналов изображения

    Обычно Mapflow обрабатывает 3-канальные изображения RGB. Платформа Mapflow также может обрабатывать одноканальные (панхроматические) изображения, но модели ИИ не настроены на такие данные, поэтому качество результата может быть хуже ожидаемого.

  • Проверяет проекцию и географическую привязку

    Убедитесь, что ваши изображения имеют географическую привязку в географической или проекционной системе координат.

  • Проверяет разрешение изображения

    Ограничения по разрешению различаются для разных моделей, см. Требования моделей

Вы можете отправить запрос на предобработку данных на help@geoalert.io

Работа с результатами

Просмотр результатов

The processing results that are 100% complete can be downloaded as a vector file to your local directory or streaming as a vector tiles and automatically added as layer to QGIS workspace.

Дважды щелкните имя обработки в таблице 1. Обработка или выберите ее и нажмите кнопку «Просмотр результатов». Слой появится на панели «Слои» (QGIS –> Вид –> Панели –> Слои) в папке «Mapflow». Дальше с ним можно работать как с обычным векторным слоем в QGIS.

Примечание

Если используется модель AI по умолчанию, плагин автоматически добавляет стили векторному слою. Для всех пользовательских моделей/сценариев назначается единый стиль по умолчанию. Вы всегда можете изменить стили.

Сохранить результаты

Результаты обработки, завершенные на 100%, могут быть скачаны в формате GeoJSON, чтобы сделать это, нажмите на кнопку Сохранить результаты, выберите выходную директорию в появившемся окне и назовите сохраняемый файл.

Удалить обработку

Чтобы удалить обработку - выберите ее в списке, нажмите кнопку «Удалить» и подтвердите.

Предупреждение

Удаленная обработка не может быть восстановлена пользователем. Перед окончательным удалением резервная копия данных временно сохраняется на сервере Mapflow на случай чрезвычайной ситуации. Так что, если вы удалили свои результаты по ошибке и хотите, чтобы мы восстановили обработку — отправьте запрос в поддержку без промедления.

Валидация результатов

Примечание

❗️ Эта опция доступна для ограниченного числа клиентов Mapflow, которые подписались на корпоративную поддержку

Если активировано, каждая завершенная обработка получает статус «Review required». Пользователь может либо принять результат, либо запросить проверку, чтобы служба поддержки могла повторно обработать его и получить лучшие результаты, пока результат не будет соответствовать требованиям. Чтобы запросить Review результатов:

  1. Выберите обработку в статусе «Review required» и нажмите кнопку «Review»

  2. Добавьте комментарии для пояснения:

  • Добавьте комментарии зачем и по каким критериям вы запрашиваете валидацию результатов

  • Опционально Добавьте область полигона, выделяя объекты, которые неправильно обработаны, неправильно идентифицированы и т. д. – это поможет нам обратить внимание на конкретные проблемы

  • Стату обработки сменится на «In review»

Загрузить TIF, выберите из списка

Выберите AOI и запросите валидацию

  1. Как только проверка будет завершена с нашей стороны, статус снова изменится на «Review required». Примите результаты или вернитесь к #1

Загрузить TIF, выберите из списка

Примите результаты по итогам валидации

Настройки прокси

Если вы находитесь за брандмауэром, перейдите в QGIS -> Настройки -> Сеть и настройте параметры прокси для подключения плагина.

Proxy settings