# dangiashish/geotagimage architecture

> Architecture diagram of the GitHub repository dangiashish/geotagimage, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dangiashish/geotagimage
- Repository: https://github.com/dangiashish/geotagimage

## Overview

GeoTagImage is an Android library for capturing photos and producing geotagged images. The documented workflow is for an app to configure the library and request permissions, launch either its CameraX interface or the system camera, then receive or process the captured image. The library obtains location and applies metadata and overlays before saving. The README also documents map previews and customization; those capabilities are included, but their internal implementation paths are not fully visible in the excerpts.

Main entry points: [`GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`](https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt) (GeoTagImage API), [`GeoTagImage/src/main/java/com/dangiashish/GTILocationUtility.kt`](https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GTILocationUtility.kt) (Location Fetch), [`GeoTagImage/src/main/java/com/dangiashish/GTIUtility.kt`](https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GTIUtility.kt) (Image Utilities), [`GeoTagImage/src/main/java/com/dangiashish/PermissionCallback.kt`](https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/PermissionCallback.kt) (Permission Callback)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["App Integration"]
  node_permissions["Permission Callback"]
end

subgraph group_capture["Camera Capture"]
  node_api["GeoTagImage API<br/>[GeoTagImage.kt]"]
  node_camera["CameraX / System<br/>[GeoTagImage.kt]"]
end

subgraph group_location["Location Data"]
  node_location["Location Fetch"]
  node_geocoding["Address Geocoding"]
end

subgraph group_image["Image Processing"]
  node_overlay["Tag and Map Overlay<br/>[GeoTagImage.kt]"]
  node_imageops["Image Utilities<br/>[GTIUtility.kt]"]
  node_metadata["EXIF Metadata<br/>[GeoTagImage.kt]"]
  node_storage[("Image Storage<br/>[GeoTagImage.kt]")]
end

node_app(("Calling App"))

node_app -->|"configures and launches"| node_api
node_app -->|"implements callbacks"| node_permissions
node_api -->|"launches capture"| node_camera
node_api -->|"fetches location"| node_location
node_api -.->|"applies tags"| node_overlay
node_api -->|"writes EXIF"| node_metadata
node_api -->|"saves image"| node_storage
node_api -.->|"uses utilities"| node_imageops
node_location -.->|"resolves address"| node_geocoding
node_overlay -.->|"uses utilities"| node_imageops
node_overlay -.->|"embeds metadata"| node_metadata

click node_api "https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt"
click node_permissions "https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/PermissionCallback.kt"
click node_camera "https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt"
click node_location "https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GTILocationUtility.kt"
click node_geocoding "https://github.com/dangiashish/geotagimage/tree/master/GeoTagImage/src/main/java/com/dangiashish"
click node_overlay "https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt"
click node_imageops "https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GTIUtility.kt"
click node_metadata "https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt"
click node_storage "https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_permissions toneBlue
class node_api,node_camera toneAmber
class node_location,node_geocoding toneMint
class node_overlay,node_imageops,node_metadata,node_storage toneRose
class node_app toneIndigo
```

## Components

### App Integration

- [Permission Callback](https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/PermissionCallback.kt): `GeoTagImage/src/main/java/com/dangiashish/PermissionCallback.kt`

### Camera Capture

- [GeoTagImage API](https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt): `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`
- [CameraX / System](https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt): `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`

### Location Data

- [Location Fetch](https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GTILocationUtility.kt): `GeoTagImage/src/main/java/com/dangiashish/GTILocationUtility.kt`
- [Address Geocoding](https://github.com/dangiashish/geotagimage/tree/master/GeoTagImage/src/main/java/com/dangiashish): `GeoTagImage/src/main/java/com/dangiashish`

### Image Processing

- [Tag and Map Overlay](https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt): `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`
- [Image Utilities](https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GTIUtility.kt): `GeoTagImage/src/main/java/com/dangiashish/GTIUtility.kt`
- [EXIF Metadata](https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt): `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`
- [Image Storage](https://github.com/dangiashish/geotagimage/blob/master/GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt): `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`

### Other components

- **Calling App**

## Connections

- Calling App → GeoTagImage API: configures and launches (evidence: `README.md`)
- Calling App → Permission Callback: implements callbacks (evidence: `README.md`)
- GeoTagImage API → CameraX / System: launches capture (evidence: `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`)
- GeoTagImage API → Location Fetch: fetches location (evidence: `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`)
- GeoTagImage API → Tag and Map Overlay: applies tags (evidence: `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`)
- GeoTagImage API → EXIF Metadata: writes EXIF (evidence: `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`)
- GeoTagImage API → Image Storage: saves image (evidence: `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`)
- GeoTagImage API → Image Utilities: uses utilities (evidence: `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`)
- Location Fetch → Address Geocoding: resolves address (evidence: `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`)
- Tag and Map Overlay → Image Utilities: uses utilities (evidence: `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`)
- Tag and Map Overlay → EXIF Metadata: embeds metadata (evidence: `GeoTagImage/src/main/java/com/dangiashish/GeoTagImage.kt`)
