# sujancse/google-map-geofence architecture

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

- Interactive diagram: https://gitdiagram.com/sujancse/google-map-geofence
- Repository: https://github.com/sujancse/google-map-geofence

## Overview

Google Maps Geofence is a small JavaScript library for drawing and editing editable polygons on a Google Map. A user supplies map options and coordinates; the library initializes the map, converts coordinates, creates and attaches a polygon, and exposes events and helpers for editing, reverting, inspecting coordinates, and creating map overlays. The README documents these capabilities; the source excerpt shows map setup, polygon drawing, event dispatch, and several helpers, but not every public method implementation.

Main entry points: [`gmap-v3-geofence.js`](https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js) (Geofence API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Map and polygon"]
  node_api["Geofence API"]
  node_map["Map setup"]
  node_polygon["Polygon drawing"]
end

subgraph group_editing["Editing and events"]
  node_events["Polygon events"]
  node_editing_helpers["Polygon editing"]
end

subgraph group_helpers["Coordinates and overlays"]
  node_coordinates["Coordinate conversion"]
  node_coordinate_helpers["Coordinate helpers"]
  node_overlays["Map overlays"]
end

node_developer(("Library user"))
node_maps["Google Maps API"]

node_developer -->|"calls API"| node_api
node_api -->|"initializes"| node_map
node_map -->|"creates map"| node_maps
node_api -->|"converts input"| node_coordinates
node_api -->|"draws polygon"| node_polygon
node_polygon -->|"creates polygon"| node_maps
node_polygon -->|"registers events"| node_events
node_events -->|"dispatches callbacks"| node_developer
node_developer -->|"edits or reverts"| node_editing_helpers
node_developer -->|"requests coordinates"| node_coordinate_helpers
node_developer -->|"creates overlays"| node_overlays
node_editing_helpers -.->|"updates polygon"| node_maps
node_overlays -.->|"creates overlays"| node_maps

click node_api "https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js"
click node_map "https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js"
click node_coordinates "https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js"
click node_polygon "https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js"
click node_events "https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js"
click node_editing_helpers "https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js"
click node_coordinate_helpers "https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js"
click node_overlays "https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js"

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_api,node_map,node_polygon,node_developer toneBlue
class node_events,node_editing_helpers toneAmber
class node_coordinates,node_coordinate_helpers,node_overlays,node_maps toneMint
```

## Components

### Map and polygon

- [Geofence API](https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js): `gmap-v3-geofence.js`
- [Map setup](https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js): `gmap-v3-geofence.js`
- [Polygon drawing](https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js): `gmap-v3-geofence.js`

### Editing and events

- [Polygon events](https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js): `gmap-v3-geofence.js`
- [Polygon editing](https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js): `gmap-v3-geofence.js`

### Coordinates and overlays

- [Coordinate conversion](https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js): `gmap-v3-geofence.js`
- [Coordinate helpers](https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js): `gmap-v3-geofence.js`
- [Map overlays](https://github.com/sujancse/google-map-geofence/blob/master/gmap-v3-geofence.js): `gmap-v3-geofence.js`

### Other components

- **Library user**
- **Google Maps API**

## Connections

- Library user → Geofence API: calls API (evidence: `README.md`)
- Geofence API → Map setup: initializes (evidence: `gmap-v3-geofence.js`)
- Map setup → Google Maps API: creates map (evidence: `gmap-v3-geofence.js`)
- Geofence API → Coordinate conversion: converts input (evidence: `gmap-v3-geofence.js`)
- Geofence API → Polygon drawing: draws polygon (evidence: `gmap-v3-geofence.js`)
- Polygon drawing → Google Maps API: creates polygon (evidence: `gmap-v3-geofence.js`)
- Polygon drawing → Polygon events: registers events (evidence: `gmap-v3-geofence.js`)
- Polygon events → Library user: dispatches callbacks (evidence: `README.md`)
- Library user → Polygon editing: edits or reverts (evidence: `README.md`)
- Library user → Coordinate helpers: requests coordinates (evidence: `README.md`)
- Library user → Map overlays: creates overlays (evidence: `README.md`)
- Polygon editing → Google Maps API: updates polygon
- Map overlays → Google Maps API: creates overlays
