# google/earthengine-api architecture

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

- Interactive diagram: https://gitdiagram.com/google/earthengine-api
- Repository: https://github.com/google/earthengine-api

## Overview

Google Earth Engine’s Python and JavaScript packages let users build server-side geospatial computations, submit them to Earth Engine, and retrieve results or display map tiles. The principal workflow is to compose operations on images and collections, serialize the resulting expression, send API requests, then consume evaluated data, exports, or visualizations. The graph includes the documented image-collection/map/reduce/display example and major client capabilities such as batch tasks, authentication, CLI access, and map overlays. Some links are grounded in the README or source index rather than inspected implementation excerpts.

Main entry points: [`python/ee/data.py`](https://github.com/google/earthengine-api/blob/master/python/ee/data.py) (API transport and data), [`python/ee/apifunction.py`](https://github.com/google/earthengine-api/blob/master/python/ee/apifunction.py) (Dynamic algorithms), [`python/ee/computedobject.py`](https://github.com/google/earthengine-api/blob/master/python/ee/computedobject.py) (EE object API), [`javascript/src/apiclient.js`](https://github.com/google/earthengine-api/blob/master/javascript/src/apiclient.js) (JS API transport)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_py_model["Python computation model"]
  node_py_objects["EE object API<br/>[computedobject.py]"]
  node_py_algorithms["Dynamic algorithms<br/>[apifunction.py]"]
  node_py_rasters["Images and collections<br/>[image.py]"]
  node_py_vectors["Features and collections"]
  node_py_geometry["Geometry and projection<br/>[geometry.py]"]
  node_py_filters["Filters and reducers<br/>[filter.py]"]
  node_py_types["Typed arguments<br/>[_arg_types.py]"]
end

subgraph group_py_runtime["Python execution and access"]
  node_py_serialize["Expression encoding<br/>[serializer.py]"]
  node_py_cloud["Cloud API utilities"]
  node_py_data["API transport and data<br/>[data.py]"]
  node_py_auth["Authentication<br/>[oauth.py]"]
end

subgraph group_py_tools["Python tools and display"]
  node_py_batch["Export and batch tasks<br/>[batch.py]"]
  node_py_cli["Command-line interface<br/>[commands.py]"]
  node_py_map["Map tile client<br/>[mapclient.py]"]
end

subgraph group_js_client["JavaScript client"]
  node_js_expr["JS expression client<br/>[ee.js]"]
  node_js_api["JS API transport<br/>[apiclient.js]"]
  node_js_data["JS data operations<br/>[data.js]"]
  node_js_types["JS domain objects<br/>[domain_object.ts]"]
  node_js_overlay["Map overlays<br/>[abstractoverlay.js]"]
  node_js_tiles["Tile management<br/>[maptilemanager.js]"]
end

node_user(("Python or JS user"))
node_earth_engine{{"Earth Engine API"}}
node_ee_tiles{{"Earth Engine tiles"}}

node_user -->|"builds expressions"| node_py_objects
node_py_objects -->|"invokes algorithms"| node_py_algorithms
node_py_rasters -->|"calls operations"| node_py_algorithms
node_py_vectors -->|"calls operations"| node_py_algorithms
node_py_geometry -->|"calls constructors"| node_py_algorithms
node_py_filters -->|"uses argument types"| node_py_types
node_py_rasters -->|"uses argument types"| node_py_types
node_py_vectors -->|"uses argument types"| node_py_types
node_py_objects -->|"encodes expressions"| node_py_serialize
node_py_objects -->|"evaluates values"| node_py_data
node_py_algorithms -->|"loads signatures"| node_py_data
node_py_data -->|"serializes requests"| node_py_serialize
node_py_data -->|"uses cloud helpers"| node_py_cloud
node_py_cloud -->|"prepares API calls"| node_earth_engine
node_py_data -->|"sends requests"| node_earth_engine
node_py_auth -->|"provides credentials"| node_py_data
node_user -->|"starts exports"| node_py_batch
node_py_batch -->|"submits tasks"| node_py_data
node_user -->|"runs commands"| node_py_cli
node_py_cli -->|"uses API"| node_py_data
node_user -->|"views map"| node_py_map
node_py_map -.->|"fetches map data"| node_earth_engine
node_user -->|"builds expressions"| node_js_expr
node_js_expr -.->|"uses client"| node_js_api
node_js_api -.->|"dispatches requests"| node_js_data
node_js_types -->|"provides request objects"| node_js_api
node_js_overlay -.->|"manages tiles"| node_js_tiles
node_js_tiles -.->|"requests tiles"| node_ee_tiles

click node_py_objects "https://github.com/google/earthengine-api/blob/master/python/ee/computedobject.py"
click node_py_algorithms "https://github.com/google/earthengine-api/blob/master/python/ee/apifunction.py"
click node_py_rasters "https://github.com/google/earthengine-api/blob/master/python/ee/image.py"
click node_py_vectors "https://github.com/google/earthengine-api/blob/master/python/ee/featurecollection.py"
click node_py_geometry "https://github.com/google/earthengine-api/blob/master/python/ee/geometry.py"
click node_py_filters "https://github.com/google/earthengine-api/blob/master/python/ee/filter.py"
click node_py_types "https://github.com/google/earthengine-api/blob/master/python/ee/_arg_types.py"
click node_py_serialize "https://github.com/google/earthengine-api/blob/master/python/ee/serializer.py"
click node_py_cloud "https://github.com/google/earthengine-api/blob/master/python/ee/_cloud_api_utils.py"
click node_py_data "https://github.com/google/earthengine-api/blob/master/python/ee/data.py"
click node_py_auth "https://github.com/google/earthengine-api/blob/master/python/ee/oauth.py"
click node_py_batch "https://github.com/google/earthengine-api/blob/master/python/ee/batch.py"
click node_py_cli "https://github.com/google/earthengine-api/blob/master/python/ee/cli/commands.py"
click node_py_map "https://github.com/google/earthengine-api/blob/master/python/ee/mapclient.py"
click node_js_expr "https://github.com/google/earthengine-api/blob/master/javascript/src/ee.js"
click node_js_api "https://github.com/google/earthengine-api/blob/master/javascript/src/apiclient.js"
click node_js_data "https://github.com/google/earthengine-api/blob/master/javascript/src/data.js"
click node_js_types "https://github.com/google/earthengine-api/blob/master/javascript/src/eeapiclient/domain_object.ts"
click node_js_overlay "https://github.com/google/earthengine-api/blob/master/javascript/src/layers/abstractoverlay.js"
click node_js_tiles "https://github.com/google/earthengine-api/blob/master/javascript/src/maptilemanager.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_py_objects,node_py_algorithms,node_py_rasters,node_py_vectors,node_py_geometry,node_py_filters,node_py_types,node_user toneBlue
class node_py_serialize,node_py_cloud,node_py_data,node_py_auth toneAmber
class node_py_batch,node_py_cli,node_py_map,node_earth_engine toneMint
class node_js_expr,node_js_api,node_js_data,node_js_types,node_js_overlay,node_js_tiles toneRose
class node_ee_tiles toneIndigo
```

## Components

### Python computation model

- [EE object API](https://github.com/google/earthengine-api/blob/master/python/ee/computedobject.py): `python/ee/computedobject.py`
- [Dynamic algorithms](https://github.com/google/earthengine-api/blob/master/python/ee/apifunction.py): `python/ee/apifunction.py`
- [Images and collections](https://github.com/google/earthengine-api/blob/master/python/ee/image.py): `python/ee/image.py`
- [Features and collections](https://github.com/google/earthengine-api/blob/master/python/ee/featurecollection.py): `python/ee/featurecollection.py`
- [Geometry and projection](https://github.com/google/earthengine-api/blob/master/python/ee/geometry.py): `python/ee/geometry.py`
- [Filters and reducers](https://github.com/google/earthengine-api/blob/master/python/ee/filter.py): `python/ee/filter.py`
- [Typed arguments](https://github.com/google/earthengine-api/blob/master/python/ee/_arg_types.py): `python/ee/_arg_types.py`

### Python execution and access

- [Expression encoding](https://github.com/google/earthengine-api/blob/master/python/ee/serializer.py): `python/ee/serializer.py`
- [Cloud API utilities](https://github.com/google/earthengine-api/blob/master/python/ee/_cloud_api_utils.py): `python/ee/_cloud_api_utils.py`
- [API transport and data](https://github.com/google/earthengine-api/blob/master/python/ee/data.py): `python/ee/data.py`
- [Authentication](https://github.com/google/earthengine-api/blob/master/python/ee/oauth.py): `python/ee/oauth.py`

### Python tools and display

- [Export and batch tasks](https://github.com/google/earthengine-api/blob/master/python/ee/batch.py): `python/ee/batch.py`
- [Command-line interface](https://github.com/google/earthengine-api/blob/master/python/ee/cli/commands.py): `python/ee/cli/commands.py`
- [Map tile client](https://github.com/google/earthengine-api/blob/master/python/ee/mapclient.py): `python/ee/mapclient.py`

### JavaScript client

- [JS expression client](https://github.com/google/earthengine-api/blob/master/javascript/src/ee.js): `javascript/src/ee.js`
- [JS API transport](https://github.com/google/earthengine-api/blob/master/javascript/src/apiclient.js): `javascript/src/apiclient.js`
- [JS data operations](https://github.com/google/earthengine-api/blob/master/javascript/src/data.js): `javascript/src/data.js`
- [JS domain objects](https://github.com/google/earthengine-api/blob/master/javascript/src/eeapiclient/domain_object.ts): `javascript/src/eeapiclient/domain_object.ts`
- [Map overlays](https://github.com/google/earthengine-api/blob/master/javascript/src/layers/abstractoverlay.js): `javascript/src/layers/abstractoverlay.js`
- [Tile management](https://github.com/google/earthengine-api/blob/master/javascript/src/maptilemanager.js): `javascript/src/maptilemanager.js`

### Other components

- **Python or JS user**
- **Earth Engine API**
- **Earth Engine tiles**

## Connections

- Python or JS user → EE object API: builds expressions
- EE object API → Dynamic algorithms: invokes algorithms (evidence: `python/ee/computedobject.py`)
- Images and collections → Dynamic algorithms: calls operations (evidence: `python/ee/image.py`)
- Features and collections → Dynamic algorithms: calls operations (evidence: `python/ee/featurecollection.py`)
- Geometry and projection → Dynamic algorithms: calls constructors (evidence: `python/ee/geometry.py`)
- Filters and reducers → Typed arguments: uses argument types (evidence: `python/ee/_arg_types.py`)
- Images and collections → Typed arguments: uses argument types (evidence: `python/ee/_arg_types.py`)
- Features and collections → Typed arguments: uses argument types (evidence: `python/ee/_arg_types.py`)
- EE object API → Expression encoding: encodes expressions (evidence: `python/ee/computedobject.py`)
- EE object API → API transport and data: evaluates values (evidence: `python/ee/computedobject.py`)
- Dynamic algorithms → API transport and data: loads signatures (evidence: `python/ee/apifunction.py`)
- API transport and data → Expression encoding: serializes requests (evidence: `python/ee/data.py`)
- API transport and data → Cloud API utilities: uses cloud helpers (evidence: `python/ee/data.py`)
- Cloud API utilities → Earth Engine API: prepares API calls
- API transport and data → Earth Engine API: sends requests (evidence: `python/ee/data.py`)
- Authentication → API transport and data: provides credentials (evidence: `python/ee/oauth.py`)
- Python or JS user → Export and batch tasks: starts exports (evidence: `python/ee/batch.py`)
- Export and batch tasks → API transport and data: submits tasks (evidence: `python/ee/batch.py`)
- Python or JS user → Command-line interface: runs commands
- Command-line interface → API transport and data: uses API (evidence: `python/ee/cli/commands.py`)
- Python or JS user → Map tile client: views map
- Map tile client → Earth Engine API: fetches map data
- Python or JS user → JS expression client: builds expressions
- JS expression client → JS API transport: uses client
- JS API transport → JS data operations: dispatches requests
- JS domain objects → JS API transport: provides request objects
- Map overlays → Tile management: manages tiles
- Tile management → Earth Engine tiles: requests tiles
