Scalable Polygon Annotation: Clean Boundaries for Geospatial Data
Annotate buildings, parcels and land cover with polygons in Supervisely: draw by hand or with AI, share boundaries, cut holes and fix mistakes.

Polygon annotation for geospatial data means outlining buildings, parcels and land cover on aerial images as shapes made of points. In Supervisely, you can draw them by hand or with Smart Tool. For map buildings and parcels, manual drawing is often faster: you snap to existing outlines, keep shared edges shared, cut holes and fix a mistake by moving one vertex.
What is polygon annotation for geospatial data?
Take an aerial image of one property: a house, a lawn, a driveway and a few planting beds. A mask stores each object as pixels. The house's straight walls come out as small steps. The lawn and the driveway are separate pixel regions, so their shared edge gets gaps or overlaps unless someone paints it by hand. A polygon stores the outline as points. A wall is one straight line, a corner is one point, the lawn and the driveway share one boundary, and a planting bed inside the lawn is a hole in it. GIS software can measure and check that shape, and a reviewer fixes it by moving a point instead of repainting pixels.
The steps below cover the whole job: use AI where it is enough, draw straight-sided objects by hand, make neighbors share edges, cut holes, fix mistakes, export with map coordinates, and run it all with a team.
Smart Tool masks for a building, lawn, paved surface and planting beds on an aerial image of a property
For the full reference, see Scalable Polygon Annotation in the Supervisely docs. It covers overlaps, self-intersections, holes, export with map coordinates and large projects.
What you need
-
An images project with aerial or satellite imagery. The example uses four classes:
Building,Lawn,Paved surfaceandPlanting bed. -
A shape for each class. If a class is only training data for a segmentation model, a mask class is enough. If its outlines go into a map, or get measured or edited later, use the Polygon shape, or Multipolygon when one object can come in several separate pieces (Step 4).
-
If the polygons need map coordinates, imagery from the Satellite, DTM & OSM Downloader app. It saves where each image sits on the map (its coordinate system, extent and pixel-to-map transform), which the export in Step 7 needs.
How do you start with AI? (Step 1)
Smart Tool creates an object from a click or two with an interactive segmentation model. Click the object to include it, and click what to leave out. It can output a pixel-perfect mask, a polygon or a multipolygon, whichever you need. In the image above, a few clicks per object outline the building, lawn, paved surface and planting beds as masks, and you give each one its class.
The model outlines what it sees, not what your guidelines say. It sees the tree canopy, not the lawn under it. It sees one paved surface where the private driveway meets the public sidewalk. Where the lawn and the driveway end is your call.
To fix a mask, the Brush Tool paints in a missing area or erases an extra one. The result is still a mask, with its edge on the pixel grid.
If the masks are for training a segmentation model, you can stop here. If the outlines go into a map, Smart Tool can give you a polygon or a multipolygon instead. For straight-edged objects like buildings, drawing the polygon yourself is often faster (Step 2).
When should you use polygons instead of masks? (Step 2)
If you already have masks, from earlier work or from a model, you don't need to redraw them. Supervisely converts a mask into a polygon, and you edit its points. This works well for irregular shapes like a planting bed or a patch of lawn, and for any mask that already follows the right edge.
The three ways to get a polygon, as described in this post:
| Approach | How it works | Best for | Watch out for |
|---|---|---|---|
| AI-assisted: Smart Tool | A click or two on the object. Outputs a mask, a polygon or a multipolygon | A quick start, irregular shapes like lawns and planting beds | The model outlines what it sees, not what your guidelines say |
| Semi-manual: mask converted to polygon | Existing mask becomes an editable polygon, then you edit its points | Irregular shapes, and masks that already follow the right edge | The outline follows the pixel edge, so straight sides become small steps with many points |
| Manual: Polygon Tool | Click each corner and press Space, or hold Shift and drag along a curve | Straight-sided objects like buildings, and shared edges (snapping) | Curves: hold Shift and drag (auto-placement of points) instead of clicking every point |
A converted outline follows the mask's pixel edge. So the straight side of a roof or a driveway becomes a row of small steps, with far more points than the shape has corners. Cleaning that up takes time, once for the annotator and again for the reviewer, and on thousands of objects it adds up. For straight-sided objects, draw the polygon directly with the Polygon Tool: click each corner and press Space to close it. A rectangular roof is four clicks and one key. For a curved edge, like a planting bed, hold Shift and the left mouse button and drag along it: the tool places the points as you go (Auto-placement of points).
Conversion also works the other way, and for a whole class at once. The Convert Class Shape app, in the project's context menu under Run App → Transform, converts every object of a class from masks to polygons, or from polygons to masks. Use the first when a model labeled a whole project with masks and you need polygons. Use the second to train a segmentation model on the same work: the polygons go to the map, and their mask copies go to training. The app approximates the outlines it makes from masks to reduce the number of points, which can cost slight accuracy at the borders.
How to draw the next object along an existing boundary (Step 3)
With the building drawn, the lawn and the driveway have to meet it exactly. If you draw each shared edge twice by hand, the two lines never quite match, and you get thin gaps and overlaps that a reviewer then has to find.
Snapping in the Polygon Tool reuses the existing outline instead: new points snap to the neighbor's points and edges (the docs call it Automatic object linking). While drawing the lawn, hover over the building and click the nearest point on its outline, then click a later point on the same outline. The lawn follows the building's edge between the two points, so both objects share one boundary.
The snap holds when you edit. Drag a point shared by two or three polygons, and all of them move with it. You fix a shared edge once, and the neighbors stay aligned.
How to cut holes instead of splitting objects (Step 4)
A planting bed in the middle of the lawn is not lawn, but cutting it out shouldn't split the lawn into pieces. Select the lawn, hold Shift and click to draw a hole. The lawn stays one object without the bed's area, and the hole has its own editable edge. To remove a hole, hover over it and press Delete.
Sometimes it's the other way around: one object in several separate pieces. The lawn in front of the house and the lawn behind it can be one lawn, with the house and the driveway between them. As two polygons they are two objects, so the lawn's area and its map feature are split in two. A class with the Multipolygon shape keeps the pieces as one object, and each piece can have its own holes: select the class and draw each piece (Polygon Tool). Smart Tool can output a multipolygon directly, and the Convert Class Shape app turns existing masks into one.
Not every overlap should be a hole. A building sits inside its parcel, and both stay separate objects. A lawn and a driveway should only touch. For each pair of classes, decide whether they may overlap, share an edge or form a hole, and write it in your annotation guidelines. Then annotators draw the same case the same way, and reviewers check against a rule. Where objects should only touch, turn on Clip new polygons against existing polygons in the toolbar (Alt + C): a new polygon is cut where it would cross an existing one, so it ends at the neighbor's edge instead of overlapping it.
How to fix mistakes without redrawing (Step 5)
A polygon whose outline crosses itself, usually because points were placed out of order, has no clear inside. GIS tools may reject it.
Fix the wrong part instead of redrawing the object. Drag, add or remove points (Shift + click removes one), or redraw a section: click a point on the polygon, draw the new section, and finish on another point of the same polygon. Only that section changes. Reviewers fix polygons from a model or another tool the same way, and the correct parts stay.
If the system that gets the data has its own rules, such as no overlaps within a layer, put them in the guidelines and check the exported shapes against them before you send them.
How do you scale it to a whole project? (Step 6)
Each of these edits saves a little time per object, and map projects have a lot of objects: Microsoft Global ML Building Footprints has about 1.4 billion building outlines, and SpaceNet more than 11 million. At that size, redrawing a shared edge, or a whole outline because of one mistake, gets expensive.
Buildings, courtyards and paved surfaces stored as separate polygons on a high-resolution urban image
The first outline can come from an annotator or from a model. If you have a model that predicts building footprints, connect it through custom model integration, and reviewers correct its output with the same Polygon Tool.
To run the work with a team:
-
Labeling Jobs and Labeling Queues hand out images to annotators.
-
Labeling Quality Control sends work to review and back for rework.
-
Labeling Performance shows active labeling time, average time per object, asset acceptance rate and review time, so you see where the time goes and which work comes back.
How to export polygons with map coordinates (Step 7)
Supervisely stores polygon points in image coordinates. If the imagery came from the Satellite, DTM & OSM Downloader, Export to OSM Format uses each image's map position to convert the polygons to longitude and latitude, and saves them as OSM XML files.
A property parcel, road surface and building annotated as separate polygons on an agricultural aerial image
This puts the outline on the map, but it is only as accurate as its sources: the imagery, its map position and the annotation. It is not survey-grade. Parcels drawn from aerial images are a good start, but a legal boundary has to be checked against cadastral records and survey plans. Before you upload anything to OpenStreetMap, check how classes map to tags and the imagery's license, and follow the OpenStreetMap import guidelines.
Summary
-
Supervisely has powerful tools for polygons and multipolygons, manual and AI-assisted with Smart Tool. For buildings and parcels, drawing by hand or semi-manually is often still faster, because you control every edge: snapping, shared edges, holes and moving one vertex.
-
Smart Tool creates a pixel-perfect mask, a polygon or a multipolygon in one or two clicks: masks to train a segmentation model, and a quick start for irregular shapes like lawns and planting beds.
-
Polygons keep a straight side as one line, a corner as one point, holes inside the object, and one shared edge between neighbors. An object in several pieces stays one Multipolygon.
-
Conversion works both ways: turn existing masks into polygons, or convert a whole class from masks to polygons and back with the Convert Class Shape app, so the same work can go to the map and to model training.
-
Snapping, clipping, shared points and section replacement let you draw a shared edge once, keep neighbors from overlapping and fix a mistake in place.
-
Imagery from the Satellite, DTM & OSM Downloader lets you export the polygons as OSM XML in map coordinates.
-
Jobs, queues, quality control and performance reports keep labeling and review for the whole team in one place.
Try Supervisely on your own imagery, or contact us about a large map project. The full guide in the docs has more on overlaps, topology and export.
Frequently asked questions
When should I use polygons instead of masks?
Use polygons when the outlines go into a map or are measured or edited later. A polygon keeps a wall as one line and a corner as one point, and neighbors can share one boundary. If a class is only training data for a segmentation model, a mask class is enough.
How do I make two polygons share a boundary?
Use snapping in the Polygon Tool. While drawing the new object, hover over its neighbor, click the nearest point on the neighbor outline and then a later point on it. The new polygon follows that edge, and shared points move together when you edit.
How do I cut a hole in a polygon?
Select the object, hold Shift and click to draw a hole. The object stays one object without that area. To remove a hole, hover over it and press Delete.
What is a multipolygon?
A multipolygon is one object made of several separate pieces, such as a lawn in front of and behind a house. A class with the Multipolygon shape keeps the pieces as one object, and each piece can have its own holes.
Can I convert masks to polygons?
Yes. Supervisely converts a mask into an editable polygon. The Convert Class Shape app converts every object of a class from masks to polygons or back, so the same work can go to a map and to model training.
Can I export polygons with map coordinates?
Yes, if the imagery came from the Satellite, DTM & OSM Downloader app. Export to OSM Format converts the polygons to longitude and latitude and saves OSM XML files. The result is not survey-grade, so check legal boundaries against cadastral records.


