> For the complete documentation index, see [llms.txt](https://codifi-fdm.gitbook.io/codifi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codifi-fdm.gitbook.io/codifi-docs/mobile-app/mapping-locations/annotation-and-measurement-tools.md).

# Annotation & Measurement Tools

Available on iPhone and iPad. Access both tools from the **Tools & Measurements** icon in the top-right map controls.

> **Screenshot placeholder:** *The map view with the Tools & Measurements icon highlighted in the top-right corner.*

***

## Annotation Mode

Annotation mode lets you draw shapes, arrows, and labels directly on the map to mark up areas of interest.

### Accessing Annotation Mode

1. Tap the **Tools & Measurements** icon in the top-right map controls.
2. Select **Annotate** from the menu.

> **Screenshot placeholder:** *The Tools & Measurements menu open, with "Annotate" highlighted.*

### Annotation Types

Choose from the following drawing tools:

* **Sketch** — Freehand drawing
* **Rectangle** — Tap and drag to draw a rectangle
* **Circle** — Tap and drag to draw a circle
* **Arrow** — Draw a directional arrow
* **Label** — Place a text label on the map

### Customizing Annotations

Each annotation tool includes:

* **Color picker** — Choose a fill or stroke color
* **Stroke width** — Select Thin, Medium, or Thick
* **Opacity slider** — Adjust the transparency of individual annotations

A **global opacity slider** is also available to adjust the visibility of all annotations at once.

### Managing Layers

Annotations are organized into layers, which you can manage from the layers panel:

* **Toggle visibility** — Turn individual layers on or off
* **Rename a layer** — Long-press a layer to rename it
* **Add notes** — Attach a note to a layer for context
* **Fit to shape** — Zoom the map to the full extent of a layer's annotations
* **Delete a layer** — Remove the layer and all of its annotations

> **Screenshot placeholder:** *The annotation layers panel showing multiple layers with toggle controls.*

***

## Measurement Mode

Measurement mode lets you calculate distances and areas directly on the map.

### Accessing Measurement Mode

1. Tap the **Tools & Measurements** icon in the top-right map controls.
2. Select **Measure** from the menu.

### Measurement Types

* **Line** — Measures distance along a path
* **Polygon** — Measures the area of an enclosed shape

### Placing Points

Two input methods are available:

* **Crosshair mode** — Tap **Add Point** to place a point at the map center. Use this for precision placement, especially when zoomed in.
* **Sketch mode** — Draw freehand on the map to place points along a path or around an area.

> **Screenshot placeholder:** *Measurement in progress on the map, showing a polygon with live area readout at the top of the sheet.*

### Units

Switch between unit systems at any time:

* **Imperial** — feet, miles, acres
* **Metric** — meters, kilometers, hectares

### Live Measurement Display

As you add points, the current measurement updates live at the top of the sheet so you can see the distance or area in real time.

### Saving Measurements

* New, unsaved measurements appear as a **dashed line** on the map.
* Tap the **checkmark** to save the measurement.
* Saved measurements appear as a **solid line** and are retained on the map.