Mapflow Web UI

Go to Mapflow and register or login using your Google account. Mapflow processes imagery and extracts vector objects from it. So as a user, you start processings, or as we call it, flows.

How to run your mapping flow

Mapflow is designed to be intuitive. Here is our step-by-step user guide:

UI Mapflow – run a flow

1. Data source

1.1. Select raster source

  • Default

Mapflow uses Mapbox Satellite imagery by default. To specify your area of interest (AOI), you can either upload your own GeoJSON file, or draw the area directly on the map (“Draw rectangle”).

  • URL

The interface of this tab allows you to:

  • Specify the XYZ link to the source of the images. The link is automatically checked for validity (for example, OpenStreetMap - https://tile.openstreetmap.org/{z}/{x}/{y}.png);

  • If the source type supports the TMS standard, i.e. it has an inverted beginning of the Y coordinate - select the appropriate setting. An example of such an open source that supports TMS is OpenAeriaMap, where you can select a specific satellite image and copy its link in TMS format (for example, https://tiles.openaerialmap.org/{z}/{x}/{y}.png);

  • Set the scale (Zoom), which will be processed. All Mapflow models have their recommended input resolution (see on the page Model description), but sometimes it can be useful to play around with the scales and compare the results;

  • Set source image coordinate reference system (espg:3857 or espg:3395);

  • Reset all entered custom parameters;

  • Return to default source.

Important

As to the source data, currently we only support RGB imagery. If you would like to upload your own GeoTIFF you can use API or our Mpflow plugin for QGIS .

1.2. Specify area of interest

Select custom XYZ

This tab is used to add a processing area. The user can draw the area using a rectangular frame or download it in GeoJSON format (draw and download, as well as view the data structure, follow this link - geojson.io).

Attention

Be aware that for now, only a single area can be drawn or uploaded per flow. If your GeoJSON file has multiple areas within its FeatureCollection, only the first one will be used. If you want to process multiple AOIs, you can split them into separate GeoJSON files and start a flow for each one separately. Batch processing may become available in the future releases. Other spatial data formats may also become available for upload in the future, although we recommend using GeoJSON since it is a de-facto standard in web mapping. It is natively supported by web mapping frameworks (e.g. Leaflet or Mapbox) and GIS like QGIS or the ArcGIS Suite.

2. AI model

Select one of the AI models (see Model description).

3. Post-processing

In this step, you can select additional processing options. Different AI models have their own options.

AI model “Buildings”:

  • Classification - we currently recognize the following building types: apartment buildings, single-household dwellings, industrial, commercial, other non-reidential (see Urban Mapping classes).

  • Merge with OSM - compare the results with the buildings in OpenStreetMap and, if a sufficient overlap has been found, use the ones from the OSM instead.

  • Simplification - simplification and polygonization of building contours.

  • Building heights - for each building, we estimate its height using its wall’s and shadow’s length. If this option is selected, all roof contours will be shifted in accordance with their height, i.e. converted to footprints.

Important

Building heights option requires a minumum area of 50 sq.km.

AI model “Forest”:

  • Tree heights - classify vegetation by height: 0-4 m for shrub (“low vegetation”), 4-10 m for regular forest (“medium forest”), 10+ m for area with tall trees (“high forest”). Clasification is dones per vegetated area, and not per single tree (see Forest Mapping classes).

4. Run the flow

At this step, you can set the name of your processing or use the initially generated one (the button allows you to generate variants of the name).

The “Start processing” will start processing.

The “Clear Selection” will clear the previously selected processing parameters.

Attention

Once you have selected the model and the processing parameters, you will see the total cost of your flow counted in Mapflow credits (our local currency units). Upon registration, you receive 500 credits for free for testing the platform (See the tariff plan).

Processing history

In this tab, a card is created with your started processing. The card displays the name and icon of the selected model, status, creation date and processing cost.

After successful ended of processing, the card can be opened to view more detailed information about the processing parameters - AI Model, Post-processing, Area, Data Source.

Processing card

Click the “View on the Map” to quickly view the processing result on the built-in interactive map.

Preview results

Important

Please rate the quality of the received processing results! Your assessment is important for further improving the Mapflow models.

The Additional parameters button includes:

Additional parameters

  • Click “Duplicate” on an existing flow to use its parameters as a starting point for a new flow (on restart with the same parameters, a new processing is started).

  • Click “Source details” on the existing flow to view information about job sourse details, such as Area of interest in geojson format and Source image url.

Options for actions with processing results will become available in the Additional parameters upon completion of processing:

  1. Download GeoJSON.

  2. “Open with geojson.io” - view the results in the browser using geojson.io.

Note

geosjon.io also allows you to save the results in a different format (CSV, KML, TopoJSON, WKT, Shapefile). Just click “Save” and select the format of your preference in the menu bar.

../_images/geojson.io.png

  1. “Open with kepler.gl” - view the results using an open-source web tool made by Uber. It is a simple but powerful tool for data scientists to explore and analyse geospatial data.

Preview map

Note

You can find detailed information about kepler.gl in the user manual.

Working with API

Mapflow provides a REST API which, for example, allows you to query for currently running flows and fetch the results. If you are developing application and want to use our API, - check out Processing API.

Important

You must follow the requirements specified with Models reference when uploading your own images for processing through the API of the Mapflow platform. Send a request using data preprocessing to help@geoalert.io.

The service uses the Basic Auth authorization type - use the API token, which must be generated in the api tab of the profile settings.

Preview map