Mapflow <> QGIS

Внимание

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

Примечание

Preview results

Присоединяйтесь к Mapflow <> QGIS проекту с открытым исходным кодом на Github.

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

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

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

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

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

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

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

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

Окно входа

Или вы можете воспользоваться протоколом OAuth 2.0, как более удобным и безопасным способом.

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

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

Также имейте в виду, что на данный момент эта функция не поддерживает прокси-серверы.

Настройка OAuth2

Информацию о том, как войти в систему с помощью OAuth, можно найти в этой секции.

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

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

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

View of the processing panel

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

# Name of the field / button

Описание

1 Processing name

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

2 Area

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

3 Data source

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

3* Zoom

Выбор масштаба используемого источника данных (в настоящее время недоступно в общедоступной версии)

3* Show preview

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

4 Модель ИИ

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

4* Your balance

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

5 Start processing

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

6 Stars for rating

Rating scores for the finished processing. Feedback field

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

The main window contains 5 tabs:

1. Project/Processing

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

3. Мои образы

4. Settings

5. Help

1. Project/Processing

Эта вкладка разделена на две части. Сначала вы увидите список ваших проектов. Здесь вы можете создавать, редактировать и удалять проекты с помощью кнопок внизу панели. Также доступны различные варианты сортировки и поиск проекта по названию.

View of the project tab

Вкладка «Проект»

Чтобы перейти к обработке выбранного проекта, необходимо дважды щелкнуть по нему или выбрать проект и нажать правая_стрелка. Чтобы вернуться к списку проектов, нажмите левая_стрелка.

Примечание

Начиная с версии плагина 3.3.0, используется обработка API v2.0.

View of the processing tab

Processing tab

Для просмотра результатов обработки нажмите кнопку «Просмотреть результаты» или дважды щелкните название обработки в таблице. Управлять обработками можно с помощью опций и кнопок в меню нижней панели («Удалить», «Переименовать», «Сохранить результаты» и т. д.). Фильтр обработки по имени доступен в верхней части панели.

Как и в Mapflow WEB, вы можете продублировать выбранную обработку и запустить ее копию с теми же параметрами с помощью кнопки «Дублировать». Дублированная обработка будет иметь новый уникальный идентификатор, но имя будет таким же, как у исходной. Переименовать его можно с помощью кнопки «Переименовать».

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

Если обработка не удалась, вы можете перезапустить ее с помощью кнопки «Перезапустить» после того, как проблема должна быть решена (Кнопка отображается в меню только в том случае, если выбранная обработка находится в статусе FAILED).

Подсказка

⬇️ To download the processing results, you can double-click on the completed processing in the list.

Подсказка

⬇️ По умолчанию результаты обработки можно загрузить в виде векторных фрагментов для более быстрого предварительного просмотра. Для скачивания результатов обработки в виде файла необходимо выбрать такой вариант: Настройки – «сохранить результаты как локальный векторный файл»

Чтобы просмотреть подробную информацию об обработке, нажмите «Подробнее». В открывшемся окне будут отображаться Имя, ID и Статус обработки, а также используемые Поставщик данных, Модель и Параметры модели. В некоторых случаях рядом с Поставщиком данных появится кнопка. Вы можете использовать его для перехода непосредственно к источнику данных, например, к коллекции «Мои изображения» или к конкретному изображению.

View of the see details window

Processing details

3. Мои образы

Чтобы загрузить изображения и обработать несколько изображений за один раз, вы можете использовать инструмент «Мои изображения», доступный в Mapflow QGIS.

Основной сценарий работы с Моими изображениями в QGIS:

../_images/my_imagery_scenario.png

Main interface:

Мои образы главные

How to run the processing using My imagery

  1. Создайте коллекцию изображений, нажав «Добавить коллекцию» (вы можете загрузить в нее изображение мгновенно или сделать это на следующем шаге);

  2. Загрузите изображения в коллекцию, нажмите «+» на выбранной коллекции и выберите способ загрузки — вы можете выбрать файл на своем устройстве или растровый слой QGIS;

  3. Теперь вы можете просмотреть всю коллекцию изображений (будет добавлен слой листов QGIS);

  4. Просмотрите загруженные изображения и просмотрите их по одному (будет добавлен слой листов QGIS):

../_images/my_imagery_images.png

  1. Для запуска обработки выберите нужную вам коллекцию или одно изображение. Выберите собственный AOI или размер коллекции/изображения с помощью кнопки «+»;

Примечание

Выбор экстента коллекции или изображения в качестве области интереса обработки:

../_images/collection_or_image_extent.png
../_images/my_imagery_run.png

Пример обработки коллекцией изображений


  1. Click «Start processing».

Подсказка

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

../_images/my_imagery_delete.png

Подсказка

Вы можете переименовывать изображения в своих коллекциях изображений:

../_images/rename_image.png

4. Settings

View of the settings tab

Эта вкладка позволяет вам управлять многими компонентами плагина:

  • Добавление, редактирование и удаление источников данных;

  • Настройте столбцы в таблицах поиска обработки и изображений;

  • Сonfigure how the processing results will be uploaded to QGIS;

    Есть два способа:

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

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

  • Включить или отключить подтверждение параметра перед началом обработки.

View of the processing confirmation

После нажатия «Начать обработку» появится подтверждение параметров.


Подсказка

This tab also contains Output directory button.

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

5. Help

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

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

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

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

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

  2. Использовать экстент изображения (будет использоваться коллекция изображений или экстент изображения, если обработка запущена с помощью Мои изображения);

  3. Create new AOI from the map canvas extent using the «+» button.

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

View of the aoi

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

Как искать определенные изображения в 🌏 Глобальной мозаике

Mapflow Imagery Search позволяет искать метаданные поставщиков мозаики (например, ArcGIS World Imagery, Global мозаика).

Примечание

🌏 Глобальная мозаика — это ежегодно обновляемая композиция спутниковых изображений, охватывающая большую часть мира. Мозаика состоит из изображений китайского спутника «Цзилинь» (RGB, 0,75–0,5 м/пиксель). Предварительный просмотр ограничен масштабом 14. 🌏 ArcGIS World Imagery — поставщик глобального покрытия, состоящего из спутниковых изображений высокого и среднего разрешения, а также аэрофотоснимков, размещенных на сервере ESRI. Периодичность обновления изображений 1-5 лет в зависимости от территории.

Как использовать Mapflow – QGIS для поиска метаданных мозаики и запуска анализа:

  1. Switch to the Tab «Imagery Search»

  2. Установите параметры фильтра поиска, включая область (это может быть ваша область анализа или холст карты), период времени, % облаков и % пересечения с AOI.

  3. В результатах поиска выберите «Тип продукта = Мозаика». Вы увидите «линию пореза» мозаичного изображения, указывающую конкретное изображение, которое используется в мозаике.

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

Примечание

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

  1. Запустите обработку. Полученная область анализа будет обрезана по месту пересечения с областью анализа.

Получите результаты на основе анализа Mosaic

Чтобы запустить обработку по всей области анализа, просто снимите выделение и используйте Источник данных: 🌏 Глобальная мозаика 2022 или Источник данных: 🌏 ArcGIS World Imagery.

How to connect to Maxar

Примечание

SecureWatch (new name - ) is a service that provides global access to high-resolution satellite images and imagery basemaps from the world leader in remote sensing, MAXAR, through the subscription model. The spatial resolution of images varies in the range from 30 cm to 1 m. All images are accompanied by metadata, including information about the acquisition date and time, cloud cover etc. In our application we implemented the special interface to connect to this service and use imagery via Mapflow’s processings pipelines.

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

    В Настройки – Добавление или редактирование поставщиков изображений выберите тип Maxar WTS, переключитесь на вкладку Поиск изображений.

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

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

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

Важно

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

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

View of the providers tab

  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. Кроме того, вы можете установить флажок «создать из видимой области карты».

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

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

Примечание

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

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

Внимание

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

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

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

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

Custom imagery source

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

Описание

Название

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

URL-адрес

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

Тип

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

Подсказка

You can define your own source of data in XYZ format. The example: https://your_site.xyz/{z}/{x}/{y}

Подсказка

Проверьте, есть ли дополнительные подключения к источникам изображений в UserGuide How To:

  1. Как подключиться к Openaerialmap

  2. Как подключиться к Nearmap

  3. How to connect to Maxar Imagery

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

Вы можете загрузить свой собственный GeoTIFF, используя My Imagery.

Важно

Пожалуйста, следуйте требованиям, указанным на странице Справочная информация по использованию платформы при загрузке собственных изображений на платформу Mapflow. Если при загрузке данных вы получаете сообщение об ошибке, ознакомьтесь с инструкцией Userguides - How To 👨🏻‍🎓.

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

    Ваши данные должны быть автоматически преобразованы в RGB, 8 бит. Чтобы предварительно обработать данные локально перед их загрузкой в ​​Mapflow, вы можете использовать скрипт предварительной обработки

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

    Both sides image dimension must not exceed 65535x65535 pixels. If you have larger images you should either cut them in smaller chunks or switch to the Mapflow Premium.

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

    Normally, the Mapflow processes 3-bands RGB rendered images. Mapflow platform can also process single-band (panchromatic) imagery, but the quality of the result may be worse than expected.

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

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

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

    The resolution restrictions vary for different models, see Требования к моделям

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

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

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

Double click on the processing name in the Processing table or select it and push the button «View results». The layer will appear in the Layers panel (QGIS –> View –> Panels –> Layers) in the folder «Mapflow». You can work with it further as with the usual vector layer in 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