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:
1. Data source
1.1. Select raster source
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;
If the source type supports the TMS standard, i.e. it has an inverted beginning of the Y coordinate - select the appropriate setting;
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;
Return to default source.
1.2. Specify area of interest
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).
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).
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.
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
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).
Working with results
The flow’s results are saved in the “Job history” panel. When this panel is opened, the status is displayed, and the previously selected processing parameters are highlighted in the main window.
Once the flow has finished, you can view the results on an interactive map or download it as vector geodata (GeoJSON).
Click “Use as template” 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 viewing the processing results are:
Download as GeoJSON.
“Open with geojson.io” - view the results in the browser using geojson.io.
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.
“View on the map” - use our custom viewer, which displays the results on top of the source satellite images.
“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.
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.
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 firstname.lastname@example.org.
The service uses the Basic Auth authorization type - use the Mapflow login and API token, which must be generated in the api tab of the profile settings.