> For the complete documentation index, see [llms.txt](https://docs.aeroai.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aeroai.io/siega-web-features/tools/annotations.md).

# Annotations

Annotations let you drop named pins on the globe with a short note or an attached image. The pins stay in your scene, show up in the Pins list inside the&#x20;panel, and can be exported to a GeoJSON file or loaded back in later.

### How to Use

Click "Annotations" in the Top Toolbar to open the Annotations panel on the right.

<figure><img src="/files/hfxg1Xt4f1v9juqOrhsl" alt=""><figcaption></figcaption></figure>

The panel has the pin form at the top, the Start Creating Pins button below the form, and the running Pins list at the bottom.

#### &#x20;Filling in the Pin Details

Type a name into the Pin Title field so the pin shows up in the list with a label you recognize.

Type a short note into the Description field if you want a text snippet attached to the pin, or click "Import File" at the bottom of the panel and pick an&#x20;image file to attach a photo to the pin instead.

When an image is attached, the Description field is replaced by an Image Preview with a "Remove Image" button so you can swap it for text again if you\
change your mind.

<figure><img src="/files/NGTiE7Jr5FoXQEWvv2Yb" alt=""><figcaption></figcaption></figure>

#### Placing Pins

Click "Start Creating Pins" to enter pin placement mode. The button label will switch to "Creating Pins..." and the form fields will lock so the same&#x20;title and description apply to every pin you drop.

Click anywhere on the globe to drop a blue pin at that location.

Click "Stop" below the active button to leave pin placement mode when you are done.

<figure><img src="/files/9pImDDmLWcbtcVcbh4Rl" alt=""><figcaption></figcaption></figure>

#### Reviewing and Zooming to a Pin

Each pin appears in the Pins list at the bottom of the panel with its title and either the description text or the attached image thumbnail.

Click the eye icon next to a pin to fly the camera to that pin's location.

Click "Clear All" below the pin controls to remove every pin from the globe and the list at once.

<figure><img src="/files/ZOiTPGSoz2RH29UhQ8N1" alt=""><figcaption></figcaption></figure>

#### Saving Pins to a File

Click "Download GeoJSON" at the bottom of the panel to save every pin in the list to a GeoJSON file on your computer.

The exported file keeps each pin's title, description or image, and coordinates so you can reload it later or share it with someone else.

#### Loading Pins from a File

Click "Import File" at the bottom of the panel and pick a .geojson or .json file that you saved earlier to bring those pins back into the scene.

The same button is also used for image attachments, and the tool decides what to do based on the file type you pick.

<figure><img src="/files/tXjbIETh8yJgduMye2He" alt=""><figcaption></figcaption></figure>

#### Notes

The pin title and description you type are reused for every pin you place during the same session of pin placement, so adjust them between sessions if you\
want different labels.

Annotations are saved to the AeroAI server when you share or save a scene so anyone who opens the link or the file will see the same pins.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.aeroai.io/siega-web-features/tools/annotations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
