# Map Markers

The Map tab displays your images on an interactive 2D map based on their GPS coordinates. This provides a geographic overview of your capture session and helps you visualize spatial coverage. It is also useful when first importing your images to quickly remove any images you do not need to process.

<figure><img src="/files/70ni1WWVAU2OQKCtyses" alt=""><figcaption></figcaption></figure>

## Accessing the Map Tab

1. Open or create a project in Chloros
2. Import images that contain GPS metadata
3. Click the **Map** <img src="/files/najVmZ0IJaVBtlsYHFK0" alt="" data-size="line"> tab in the left sidebar
4. The map will display markers at each image's GPS location

{% hint style="info" %}
**GPS Required**: Only images with embedded GPS coordinates in their EXIF metadata will appear on the map. Ensure your camera has GPS enabled during capture.
{% endhint %}

***

## Adjusting Images from Map Tab

The **Map** <img src="/files/najVmZ0IJaVBtlsYHFK0" alt="" data-size="line"> tab has the same add  <img src="/files/qvZ2OifYYt4PI7dbbwiU" alt="" data-size="line">   <img src="/files/KWQ7Q5cb3vVWeRo5lbh7" alt="" data-size="line">  and remove  <img src="/files/Mp1knlApuIMBiCLyIgzG" alt="" data-size="line">  file buttons as the [**File Browser**](/chloros/processing-images-gui/adding-files-to-a-project.md) <img src="/files/yDndZuJw9lwULc0tT3eG" alt="" data-size="line"> tab does. It also shows the same project file table list but with different column headers:

### File Name

* Original filename from the camera
* Maintains camera naming convention (e.g., IMG\_0001.RAW)

### Latitude

* The image's latitude

### Longitude

* The image's longitude

### Altitude

* The image's altitude

{% hint style="info" %}
Clicking the table column headers also sorts the row data
{% endhint %}

***

## Image Markers

Each image with GPS data is represented by a marker on the map:

### Marker Display

* Markers indicate the exact GPS coordinates where each image was captured
* Clustered markers may group together when zoomed out
* Zoom in to see individual image locations

{% hint style="success" %}
SUPER-ZOOM: When you reach the maximum zoom level from the map tile provider the tile is then enlarged upon further zoom, allowing you to see markers that are close together.
{% endhint %}

### Hover Preview

* **Hover your mouse** over any marker to see a thumbnail preview of that image
* This allows quick visual identification without leaving the map view
* Useful for locating specific images within a large capture session

***

## Map Tile Providers

{% hint style="success" %}
**Automatic Selection**: Chloros automatically chooses the tile service that provides the best zoom level for your current map location. You can manually switch between providers if desired.
{% endhint %}

The Map tab supports two tile providers for the background map imagery:

### Google Maps

* Standard satellite and map imagery from Google
* Best for general worldwide coverage

### ESRI

* Satellite and aerial imagery from ESRI ArcGIS
* Often provides higher resolution imagery in certain regions

***

## Map Tile Types

You can choose the map layer type (from left to right):

&#x20;<img src="/files/gLovcg9ZROMBpbMYjjHw" alt="" data-size="original">

### Terrain

Shows elevation profiles and map tiles with details (roads, etc)

### Map

Shows standard (lower bandwidth) map tiles with details (roads, etc)

### Satellite

Shows detailed (higher bandwidth) satellite map tiles

### Hybrid

Shows satellite map tiles with added details (roads, etc)

***

## Map Navigation

### Zoom Controls

* **Zoom In/Out**: Use mouse scroll wheel or zoom buttons
* **Fullscreen**: Fullscreen the map

### Pan Controls

* **Pan**: Click and drag to move around the map

***

## Use Cases

### Flight Path Visualization

* View the coverage area of drone capture sessions
* Identify gaps in image coverage
* Verify flight path execution

### Ground Survey Review

* See the spatial distribution of ground-based captures
* Locate calibration target images relative to survey area
* Plan additional capture locations

### Quality Control

* Quickly identify images captured in unexpected locations
* Verify GPS accuracy across the dataset
* Cross-reference image locations with field notes

***

## Troubleshooting

### No Markers Appearing

**Possible causes:**

* Images do not contain GPS metadata
* GPS was disabled on camera during capture
* EXIF data was stripped by external software

**Solution**: Verify GPS is enabled on your camera and re-import original files

### Markers in Wrong Location

**Possible causes:**

* Camera GPS had poor satellite fix
* GPS drift during capture

**Solution**: This is typically a capture-time issue; consider using PPK/RTK GPS for precision applications


---

# Agent Instructions: 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:

```
GET https://mapir.gitbook.io/chloros/image-viewer-gui/map-markers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.