---
title: "Annotating an orthomosaic"
description: "Mark up an orthomosaic with labelled points, lines and polygons, and find your annotations again later."
---

# Annotating an orthomosaic

Annotations let you mark up a map with your own points, lines and polygons, such as a
parked vehicle, a footpath or the outline of a garden bed. Each has a name,
a colour and a comment thread.

![Adding two points, a line and a polygon to an orthomosaic and naming them, commenting on one, then reopening the map to find the comment still there](https://www.droidmap.com/docs/annotating-an-orthomosaic/demo.webp)

## Before you start

You need an **asset set** that contains an orthomosaic. An orthomosaic is
produced when a mapping job finishes, and it appears in the asset set's **Map
Assets** section alongside the elevation models (DSM and DTM).

## 1. Open the orthomosaic in the advanced map

Open the project, go to **Asset Sets**, and open the asset set. Then either:

- **click the orthomosaic's card** in the **Map Assets** section, or
- **click Advanced view** at the right-hand end of the **Map Assets** heading.

![An asset set page, with the orthomosaic card and the Advanced view button in the Map Assets section](https://www.droidmap.com/docs/annotating-an-orthomosaic/asset-set.webp)

Both open the advanced map with the orthomosaic loaded. The breadcrumb at the
top ends in **advanced map**. The map has three parts:

- **Contents**, on the left, lists your annotations under **Features**, the
  asset set's GeoJSON, KML and KMZ files under **Files** (along with any you
  [add from other sets](https://www.droidmap.com/docs/viewing-and-sharing-results#add-a-file-from-another-asset-set)),
  and its maps under **Rasters**.
- **The toolbar**, over the map, holds the tools: **Select**, **Measure**,
  **Annotate**, **Segment** and **Analyze**.
- **The Inspector**, on the right, shows the details of whatever you have
  selected, or a summary of the asset set when nothing is selected.

![The advanced map, with Contents on the left, the toolbar over the orthomosaic and the Inspector on the right](https://www.droidmap.com/docs/annotating-an-orthomosaic/advanced-map.webp)

## 2. Switch on Annotate

Click **Annotate** in the toolbar, or press **A** while the map has the focus.
The Inspector shows Annotate's options: the **Shape** to draw, your **Labels**,
and the **Style for the next shape**.

![Annotate switched on, with its options in the Inspector and no annotations yet](https://www.droidmap.com/docs/annotating-an-orthomosaic/annotate-tool.webp)

## 3. Draw an annotation

Choose **Point**, **Line** or **Polygon** under **Shape**, then draw on the map:

- **Point:** click the map once.
- **Line:** click to add each point. Press **Enter**, or double-click, to finish.
- **Polygon:** click to add each corner. Click the first corner again, press
  **Enter**, or double-click, to close it.

Press **Backspace** to remove the last point you placed, and **Escape** to drop
the shape you are drawing.

As soon as you finish a shape, it is saved. There is no save button to press.
It is named automatically, *Annotation 1*, *Annotation 2* and so on, and the
Inspector shows it under **Last drawn**. To give it a name of your own, type in
**Name** there and press **Enter**. The name is shown on the map and in
Contents.

Annotate stays on after each shape, so you can go straight on to the next one.
To pick a colour for the next shape first, use **Style for the next shape**.
To stop drawing, press **Escape** or click **Select**. The last shape you drew
is then selected.

## 4. Use labels for shapes you draw again and again

Every name you give a shape becomes a **label** in the Inspector, numbered 1, 2,
3 and so on. To draw more shapes with the same name and colour, click the label,
or press its number key (**1** to **9**) while the map has the focus, then draw.
The Inspector says **Next shapes:** and the label's name. Click **Clear label**
to go back to automatic names.

In Contents, annotations with the same name are grouped under it, with a count.

![Two parked cars, a footpath and a garden bed on the orthomosaic, with their labels in the Inspector and their groups in Contents](https://www.droidmap.com/docs/annotating-an-orthomosaic/labels.webp)

## 5. Select, change and comment on an annotation

To select an annotation, click it on the map while **Select** is on. You can
also open its group in Contents with the arrow beside its name, and click the
annotation there, which moves the map to it. Press **Escape** to clear the
selection.

The Inspector then shows the annotation, and changes are saved as you make them:

- **Rename it** in **Name**, then press **Enter**.
- **Give it a label's name and colour** by clicking the label.
- **Change its style** with **Stroke colour** and **Stroke width**. A polygon
  also has **Fill colour** and **Fill opacity**.
- **Comment on it**: type in *Add a comment…* and click **Add**.
- **Change its shape**: click **Edit shape**, drag its points, then click
  **Finish**, or **Cancel** to leave it as it was.

![The Parked car annotation selected, with a comment added](https://www.droidmap.com/docs/annotating-an-orthomosaic/editing-and-comments.webp)

## 6. Delete an annotation

Select it and click **Delete annotation**, or press **Delete**. It goes from the
map straight away, and a message says so. Click **Undo** in the message, or
press **Ctrl+Z** (**⌘Z** on a Mac), to bring it back.

The bin beside a group in Contents deletes every annotation in that group, and
can be undone the same way.

![The Footpath annotation deleted, with Undo in the message](https://www.droidmap.com/docs/annotating-an-orthomosaic/deleted-with-undo.webp)

## 7. Hide and show annotations

Each group and each annotation in Contents has an eye. Click it to hide them
from the map, and again to show them. The eye beside the **Features** heading
hides everything listed under it at once, measurements and detections too.
Drawing something new shows them all again. Hiding only changes your view, and
nothing hidden stays hidden when you open the map again.

## 8. Export your annotations

To use your annotations in a GIS tool such as QGIS, clear the selection with
**Escape** so the Inspector shows the asset set's summary, then click **Export
annotations as GeoJSON**. Your browser downloads a single `.geojson` file
containing every annotation saved to the asset set, hidden or shown, and not
only the ones on screen.

Each annotation is one feature, in WGS84 longitude and latitude. Its properties
hold:

- its `name` and `id`
- when it was `created` and last `updated`
- its style, as `stroke`, `stroke-width`, `stroke-opacity`, `fill` and
  `fill-opacity` (a point has a `marker-color` instead)
- its `comments`, if it has any

## Where your annotations are saved

Annotations are saved to the **asset set**, not to the single orthomosaic you
drew them on. That means:

- They are saved to DroidMap as soon as you draw them, so they are there the
  next time you open the map, on any device.
- Everyone with access to the project sees the same annotations.
- They show over every map layer in the asset set: the orthomosaic, the
  elevation models, and any other raster you switch to in the same asset set.
- An annotation drawn in one asset set does not appear in a different asset set,
  even one covering the same area.

To find them again, open the asset set and click **Advanced view** (or the
orthomosaic's card). Under **Features** in Contents, each label has a row with
the number of annotations it has in the whole asset set. Open a label with its
arrow to list the ones in the part of the map you are looking at.

![The advanced map reopened later, with each label listed in Contents and the comment still on Parked car](https://www.droidmap.com/docs/annotating-an-orthomosaic/after-reload.webp)

## Troubleshooting

**An annotation was not saved.** Your drawing is kept on the map, and a message
over the map says it was not saved, with **Retry** and **Discard** buttons.
Check your connection and click **Retry**.

**The export failed.** Nothing is downloaded unless every annotation loads.
Check your connection and click **Export annotations as GeoJSON** again.

**Contents says there are too many annotations in view to draw them all.** The
map loads the annotations in the part of the map you are looking at, up to a
limit. When there are more than that, Contents says *Too many annotations in
view to draw them all. Zoom in to see every one.* and only some are drawn.
Zoom in until the message goes away. The counts beside each label always
cover the whole asset set, and hiding, zooming to or deleting a label applies
to all of its annotations, including ones not drawn.

**The export says annotations were being deleted.** Deleting annotations while
an export is running could leave some out of the file, so the export starts
again when it sees one go, and stops if that keeps happening. Wait until the
deleting has finished, then export again.
