# esri/esri-leaflet architecture

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

- Interactive diagram: https://gitdiagram.com/esri/esri-leaflet
- Repository: https://github.com/esri/esri-leaflet

## Overview

Esri Leaflet is a Leaflet plugin for displaying ArcGIS basemaps and tiled, dynamic, image, raster, and feature services, and for querying and identifying service data. A map application uses the layers or service/task APIs; service operations build requests, which the shared transport sends to ArcGIS and returns through callbacks. Feature layers additionally manage spatially loaded features and edits. The graph preserves documented layer capabilities and sampled task/service relationships; unsampled layer internals are not inferred beyond README-supported capabilities.

Main entry points: [`src/Services/Service.js`](https://github.com/esri/esri-leaflet/blob/master/src/Services/Service.js) (Service base), [`src/Services/MapService.js`](https://github.com/esri/esri-leaflet/blob/master/src/Services/MapService.js) (Map service), [`src/Services/FeatureLayerService.js`](https://github.com/esri/esri-leaflet/blob/master/src/Services/FeatureLayerService.js) (Feature service), [`src/Tasks/Query.js`](https://github.com/esri/esri-leaflet/blob/master/src/Tasks/Query.js) (Query task)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_layers["Leaflet Layers"]
  node_basemap["Basemap layer<br/>[BasemapLayer.js]"]
  node_tiled["Tiled map layer<br/>[TiledMapLayer.js]"]
  node_dynamic["Dynamic map layer<br/>[DynamicMapLayer.js]"]
  node_image_layer["Image map layer<br/>[ImageMapLayer.js]"]
  node_raster["Raster layer<br/>[RasterLayer.js]"]
  node_feature_layer["Feature layer<br/>[FeatureLayer.js]"]
  node_feature_grid["Feature grid<br/>[FeatureGrid.js]"]
  node_feature_manager["Feature manager<br/>[FeatureManager.js]"]
end

subgraph group_services["Service APIs"]
  node_feature_service["Feature service"]
  node_map_service["Map service<br/>[MapService.js]"]
  node_image_service["Image service<br/>[ImageService.js]"]
  node_service["Service base<br/>[Service.js]"]
end

subgraph group_tasks["Query and Identify"]
  node_query["Query task<br/>[Query.js]"]
  node_find["Find task<br/>[Find.js]"]
  node_identify_base["Identify base<br/>[Identify.js]"]
  node_identify_features["Feature identify"]
  node_identify_image["Image identify<br/>[IdentifyImage.js]"]
  node_task["Task base<br/>[Task.js]"]
end

subgraph group_core["Request Core"]
  node_request["HTTP and JSONP<br/>[Request.js]"]
  node_utility["GIS utilities<br/>[Util.js]"]
  node_support["Browser support<br/>[Support.js]"]
end

node_developer(("Map application"))
node_arcgis{{"ArcGIS services"}}

node_developer -->|"adds layer"| node_basemap
node_developer -->|"adds layer"| node_tiled
node_developer -->|"adds layer"| node_dynamic
node_developer -->|"adds layer"| node_image_layer
node_developer -->|"adds layer"| node_feature_layer
node_feature_layer -->|"uses manager"| node_feature_manager
node_feature_manager -->|"extends grid"| node_feature_grid
node_feature_manager -->|"creates service"| node_feature_service
node_feature_manager -->|"queries features"| node_feature_service
node_feature_layer -.->|"renders raster"| node_raster
node_tiled -->|"reads metadata"| node_map_service
node_feature_service -->|"extends"| node_service
node_map_service -->|"extends"| node_service
node_image_service -->|"extends"| node_service
node_feature_service -->|"creates query"| node_query
node_map_service -->|"creates query"| node_query
node_map_service -->|"creates find"| node_find
node_map_service -->|"creates identify"| node_identify_features
node_image_service -->|"creates query"| node_query
node_image_service -->|"creates identify"| node_identify_image
node_identify_features -->|"extends"| node_identify_base
node_identify_image -->|"extends"| node_identify_base
node_query -->|"extends"| node_task
node_find -->|"extends"| node_task
node_identify_base -->|"extends"| node_task
node_task -->|"delegates request"| node_service
node_service -->|"sends request"| node_request
node_request -->|"HTTP or JSONP"| node_arcgis
node_service -->|"checks CORS"| node_support
node_query -->|"converts response"| node_utility
node_feature_service -->|"converts features"| node_utility

click node_basemap "https://github.com/esri/esri-leaflet/blob/master/src/Layers/BasemapLayer.js"
click node_tiled "https://github.com/esri/esri-leaflet/blob/master/src/Layers/TiledMapLayer.js"
click node_dynamic "https://github.com/esri/esri-leaflet/blob/master/src/Layers/DynamicMapLayer.js"
click node_image_layer "https://github.com/esri/esri-leaflet/blob/master/src/Layers/ImageMapLayer.js"
click node_raster "https://github.com/esri/esri-leaflet/blob/master/src/Layers/RasterLayer.js"
click node_feature_layer "https://github.com/esri/esri-leaflet/blob/master/src/Layers/FeatureLayer/FeatureLayer.js"
click node_feature_grid "https://github.com/esri/esri-leaflet/blob/master/src/Layers/FeatureLayer/FeatureGrid.js"
click node_feature_manager "https://github.com/esri/esri-leaflet/blob/master/src/Layers/FeatureLayer/FeatureManager.js"
click node_feature_service "https://github.com/esri/esri-leaflet/blob/master/src/Services/FeatureLayerService.js"
click node_map_service "https://github.com/esri/esri-leaflet/blob/master/src/Services/MapService.js"
click node_image_service "https://github.com/esri/esri-leaflet/blob/master/src/Services/ImageService.js"
click node_service "https://github.com/esri/esri-leaflet/blob/master/src/Services/Service.js"
click node_query "https://github.com/esri/esri-leaflet/blob/master/src/Tasks/Query.js"
click node_find "https://github.com/esri/esri-leaflet/blob/master/src/Tasks/Find.js"
click node_identify_base "https://github.com/esri/esri-leaflet/blob/master/src/Tasks/Identify.js"
click node_identify_features "https://github.com/esri/esri-leaflet/blob/master/src/Tasks/IdentifyFeatures.js"
click node_identify_image "https://github.com/esri/esri-leaflet/blob/master/src/Tasks/IdentifyImage.js"
click node_task "https://github.com/esri/esri-leaflet/blob/master/src/Tasks/Task.js"
click node_request "https://github.com/esri/esri-leaflet/blob/master/src/Request.js"
click node_utility "https://github.com/esri/esri-leaflet/blob/master/src/Util.js"
click node_support "https://github.com/esri/esri-leaflet/blob/master/src/Support.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_basemap,node_tiled,node_dynamic,node_image_layer,node_raster,node_feature_layer,node_feature_grid,node_feature_manager toneBlue
class node_feature_service,node_map_service,node_image_service,node_service toneAmber
class node_query,node_find,node_identify_base,node_identify_features,node_identify_image,node_task toneMint
class node_request,node_utility,node_support toneRose
class node_developer,node_arcgis toneIndigo
```

## Components

### Leaflet Layers

- [Basemap layer](https://github.com/esri/esri-leaflet/blob/master/src/Layers/BasemapLayer.js): `src/Layers/BasemapLayer.js`
- [Tiled map layer](https://github.com/esri/esri-leaflet/blob/master/src/Layers/TiledMapLayer.js): `src/Layers/TiledMapLayer.js`
- [Dynamic map layer](https://github.com/esri/esri-leaflet/blob/master/src/Layers/DynamicMapLayer.js): `src/Layers/DynamicMapLayer.js`
- [Image map layer](https://github.com/esri/esri-leaflet/blob/master/src/Layers/ImageMapLayer.js): `src/Layers/ImageMapLayer.js`
- [Raster layer](https://github.com/esri/esri-leaflet/blob/master/src/Layers/RasterLayer.js): `src/Layers/RasterLayer.js`
- [Feature layer](https://github.com/esri/esri-leaflet/blob/master/src/Layers/FeatureLayer/FeatureLayer.js): `src/Layers/FeatureLayer/FeatureLayer.js`
- [Feature grid](https://github.com/esri/esri-leaflet/blob/master/src/Layers/FeatureLayer/FeatureGrid.js): `src/Layers/FeatureLayer/FeatureGrid.js`
- [Feature manager](https://github.com/esri/esri-leaflet/blob/master/src/Layers/FeatureLayer/FeatureManager.js): `src/Layers/FeatureLayer/FeatureManager.js`

### Service APIs

- [Feature service](https://github.com/esri/esri-leaflet/blob/master/src/Services/FeatureLayerService.js): `src/Services/FeatureLayerService.js`
- [Map service](https://github.com/esri/esri-leaflet/blob/master/src/Services/MapService.js): `src/Services/MapService.js`
- [Image service](https://github.com/esri/esri-leaflet/blob/master/src/Services/ImageService.js): `src/Services/ImageService.js`
- [Service base](https://github.com/esri/esri-leaflet/blob/master/src/Services/Service.js): `src/Services/Service.js`

### Query and Identify

- [Query task](https://github.com/esri/esri-leaflet/blob/master/src/Tasks/Query.js): `src/Tasks/Query.js`
- [Find task](https://github.com/esri/esri-leaflet/blob/master/src/Tasks/Find.js): `src/Tasks/Find.js`
- [Identify base](https://github.com/esri/esri-leaflet/blob/master/src/Tasks/Identify.js): `src/Tasks/Identify.js`
- [Feature identify](https://github.com/esri/esri-leaflet/blob/master/src/Tasks/IdentifyFeatures.js): `src/Tasks/IdentifyFeatures.js`
- [Image identify](https://github.com/esri/esri-leaflet/blob/master/src/Tasks/IdentifyImage.js): `src/Tasks/IdentifyImage.js`
- [Task base](https://github.com/esri/esri-leaflet/blob/master/src/Tasks/Task.js): `src/Tasks/Task.js`

### Request Core

- [HTTP and JSONP](https://github.com/esri/esri-leaflet/blob/master/src/Request.js): `src/Request.js`
- [GIS utilities](https://github.com/esri/esri-leaflet/blob/master/src/Util.js): `src/Util.js`
- [Browser support](https://github.com/esri/esri-leaflet/blob/master/src/Support.js): `src/Support.js`

### Other components

- **Map application**
- **ArcGIS services**

## Connections

- Map application → Basemap layer: adds layer (evidence: `README.md`)
- Map application → Tiled map layer: adds layer (evidence: `README.md`)
- Map application → Dynamic map layer: adds layer (evidence: `README.md`)
- Map application → Image map layer: adds layer (evidence: `README.md`)
- Map application → Feature layer: adds layer (evidence: `README.md`)
- Feature layer → Feature manager: uses manager (evidence: `src/Layers/FeatureLayer/FeatureLayer.js`)
- Feature manager → Feature grid: extends grid (evidence: `src/Layers/FeatureLayer/FeatureManager.js`)
- Feature manager → Feature service: creates service (evidence: `src/Layers/FeatureLayer/FeatureManager.js`)
- Feature manager → Feature service: queries features (evidence: `src/Layers/FeatureLayer/FeatureManager.js`)
- Feature layer → Raster layer: renders raster
- Tiled map layer → Map service: reads metadata (evidence: `src/Layers/TiledMapLayer.js`)
- Feature service → Service base: extends (evidence: `src/Services/FeatureLayerService.js`)
- Map service → Service base: extends (evidence: `src/Services/MapService.js`)
- Image service → Service base: extends (evidence: `src/Services/ImageService.js`)
- Feature service → Query task: creates query (evidence: `src/Services/FeatureLayerService.js`)
- Map service → Query task: creates query (evidence: `src/Services/MapService.js`)
- Map service → Find task: creates find (evidence: `src/Services/MapService.js`)
- Map service → Feature identify: creates identify (evidence: `src/Services/MapService.js`)
- Image service → Query task: creates query (evidence: `src/Services/ImageService.js`)
- Image service → Image identify: creates identify (evidence: `src/Services/ImageService.js`)
- Feature identify → Identify base: extends (evidence: `src/Tasks/IdentifyFeatures.js`)
- Image identify → Identify base: extends (evidence: `src/Tasks/IdentifyImage.js`)
- Query task → Task base: extends (evidence: `src/Tasks/Query.js`)
- Find task → Task base: extends (evidence: `src/Tasks/Find.js`)
- Identify base → Task base: extends (evidence: `src/Tasks/Identify.js`)
- Task base → Service base: delegates request (evidence: `src/Tasks/Task.js`)
- Service base → HTTP and JSONP: sends request (evidence: `src/Services/Service.js`)
- HTTP and JSONP → ArcGIS services: HTTP or JSONP (evidence: `src/Request.js`)
- Service base → Browser support: checks CORS (evidence: `src/Services/Service.js`)
- Query task → GIS utilities: converts response (evidence: `src/Tasks/Query.js`)
- Feature service → GIS utilities: converts features (evidence: `src/Services/FeatureLayerService.js`)
