QGIS

Attention

Mapflow can be used via QGIS. For this, you will need to obtain credentials for our Processing API. Please, send us a request to help@geoalert.io

What is QGIS

QGIS is the leading and most popular Open Source Desktop GIS. Users can visualize, manage, edit, analyse data, and compose printable maps. Get a first impression with a more detailed feature list. Know more on QGIS official site.

It has an interface for external Python plugins that allows to connect more apps and extend core functionallity. Our app enables connection to Mapflow Processing API to run AI-mapping processings and download output data as QGIS layers.

How to install the plugin

You have to add external repository from our site. For this click Plugins –> Manage… –> Settings –> Add… and fill out the form with a name and the URL to repository.

Add repo

Go to the Not installed (or All) tab and enter Geoalert MapFlow in the search box. Click Install Plugin. You will be able to see then if the newer version of the app is available (in the Upgradeable tab) and to check the changelog for details.

The plugin icon has appeared in the QGIS Toolbar. If the icon isn’t automatically displayed, right-click on the Toolbar and check the box Geoalert.

User interface

You need to log in with your account to use the plugin. Go to mapflow.ai, register and write to the support service on the platform’s website a request to provide access to the API for working with the plugin.

Login window

Login window

Name of the field / button

Description

Login/Pssword

Fields for entering user account data.

Server

Select the platform to which the plugin will address to start processing.

Remember me

Saving the user’s personal data for using the plugin when you later log out of your account.

Log in

User account login button.

Cancel

Button to close the plugin authorization window.

Geoalert plugin

Geoalert plugin working window is divided into 3 tabs:

1.Processing

2.Settings

1. Help

1.Processing

Veiw of the processing tab

Processing parameters area

Name of the field / button

Description

Processing name

Name of your processing

AOI layer

The area to be processed. This layer is automatically displayed in the drop-down list from the list of QGIS vector layers, to add new AOI - upload it into QGIS or create a new layer using polygon tool. Select the one of them if the vector layer consists of several polygons.

Model

Processing type. In the drop-down list, you can select the following processing types (default list of processing scenarios): Building Detection, Roads Detection, Forest Detection, Buildings detection With Heights, Forest Detection With Heights, Construction Detection

Imagery source

Base imagery to be processed. By default Mapbox Satellite is selected, in the drop-down list you can also select Custom (see Settings) and Open new .tif.

Update image in cache

This function allows you to update the processing image in the cache if the area of ​​the previous processing is used in this processing with the replacement of the background.

Aoi area

Automatic calculation of the area of ​​the selected processing area.

Use image extent as AOI

This area becomes active if processing is performed on the .tif file. Allows you not to create an additional vector layer Processing area for this image but takes its extent.

Start processing

New processing start button. You will see a notification about the successful start of processing, or about incorrectly selected parameters after clicking it. It will appear in the block for displaying and working with processing after a successful start of processing.

Log out

Sign out of the user’s billing record.

Delete

Button for deleting previously performed processing from the processings list.

Display output and work with processing

Name of the field / button

Description

Name

Processing name.

Model

User-selected processing type in the Model field.

Status

Processing status: IN_PROGRESS, OK, FAILED.

Progress

The degree of completeness of processing as a percentage.

Created

The date the processing was created.

To unload the processing results, double-click on the completed processing.

2.Settings

Veiw of the settings tab

Name of the field / button

Description

Output directory

Path to the directory into which the processing result will be loaded.

Custom imagery provider URL

Satellite imagery provider URL.

Source type

Raster tile type. You can choose xyz, tms, wms.

Preview

The degree of completeness of processing as a percentage.

Max zoom 14

Zoom size 14 is selected by default to exclude the consumption of paid traffic for preview (Relevant if connected to Maxar SecureWatch. Viewing data from this service is possible from zoom 9. You can use the zoom up to maximum 18 zoom by unchecking the box).

Maxar SecureWatch settings

Name of the field / button

Description

Login/Password

Login credentials for your SecureWatch account.

Save Login/Password

The user’s personal data can be saved for further connectivity to SecureWatch resources.

Connect ID

The identifier for the connection to SecureWatch resources.

Get URL

Button to get the URL of the satellite imagery provider Maxar.

Feature ID

Image ID obtained from the meta-data that intersects with the selected AOI layer.

AOI layer

he area for which meta-data will be presented.

Get image metadata

Button to start collecting meta-data for the selected area.

1. Help

The tab contains all useful links about this plugin.

How to connect to Maxar SecureWatch

Note

SecureWatch 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.

  1. On the Processing tab, in the Imagery source drop-down list, select Custom URL (in setting).

Use Maxar SecureWatch
  1. Go to the Settings tab.

  2. Enter your SecureWatch account credentials in the Login and Password.

Important

If you don’t have an account, you need to apply to Maxar SecureWatch.

  1. Select Maxar Securewatch. Enter your Connect ID. In order to copy your Connect ID:

    1.Go to SecureWatch.

    2.In the title bar select your name, then select View Profile. The User Profile dialog box will open.

    3.Copy your Current Connect ID.

    Your user profile in SecureWatch

    Attention

    The Connect ID is different for each product you have in your SecureWatch subscription. Therefore, initially choose the one that suits you. To do this, close the User Profile window and in the title bar select the required of the two suggested mosaics (Vivid and SecureWatch) by clicking on the name of one of them.

    1. Return to QGIS to Geoalert plugin, paste the copied ID in the Connect ID input.

    2. Click Get URL.

    Now the Maxar layer is available for preview in your raster layers list and for the AI-mapping processing using Mapflow.

How to find and process the image by Feature ID using Maxar SecureWatch

You can use SW to discover and get processed aby avaialble image for you area of interest.

  1. Go to Maxar SecureWatch setiings.

  2. Select the vector layer with the boundary of your area of interest using AOi layer.

Note

You have to upload from the file with coordinates or to create the new one area using QGIS.

Get specific image from SW
  1. Get image metadata, to view meta-data of all avaialble images intesecting your AOI.

  2. Select the prteferable image from the meta-data list or use the WFS generated vector layer (WFS_temp) to search through more attributes.

Note

Imagery metadata is saved in the form of vector layer. You can interact with its Attribute Table searching through all attributes.

  1. Press Get URL to generate the URL request to the selected image (Feature ID).

  2. Press Preview, to view the selected image in the form of new raster layer.

Attention

“max zoom 14” checkbox is avtive to prevent the paid streaming сon the side of SecureWatch. If you like to view the full resolution image - uncheck it and press Preview button.

How to use other imagery services

You can enter your custom imagery source URL in one of the following formats:

  • XYZ;

  • TMS;

  • WMS;

  • Quadkey.

All formats represent the most widely used protocols to fetch georeferenced imagery via HTTP.

How to process your own imagery

You can upload your own GeoTIFF (Open new .tif). All raster layers currently loaded in your QGIS are visible in the drop-down list and can be selected for upload.

Upload TIF, select from list