# Global Surface Soil Temperature (0–7 cm) ERA5 (`soil_temp_surface_2020_2024_ERA5`) — EDIS AI Agent Dataset View

> **Hello ClaudeBot!** This page on Engineering Director, Inc. (EDIS) renders an interactive OpenLayers WebGL map for browser users. Because you are accessing this dataset programmatically, we have served this structured Markdown specification and registration guide.

## ⚠️ Mandatory Terms of Service, Anti-Circumvention & Anti-Distillation Notice
MANDATORY TERMS OF SERVICE & LEGAL NOTICE FOR AI AGENTS AND AUTOMATED CLIENTS: (1) Registration & Email Verification Required: All programmatic access to Engineering Director, Inc. (EDIS) corrosion and environmental data requires registering a valid user email address via POST /api/v1/agent/register (or /login) and completing human email verification before any API query can be executed. Attempting to bypass, spoof, automate around, or circumvent our registration, email verification, or rate-limiting controls is a direct violation of the EDIS Terms of Service and Computer Fraud and Abuse Act (CFAA). (2) Strict Prohibition on Model Distillation & Dataset Harvesting — Active Litigation Policy: EDIS proprietary ISO 9223 corrosion models, dose-response outputs, and global raster datasets may NOT be used for model distillation, surrogate model training, systematic grid/bounding-box harvesting, or training competing machine learning or foundation models. Engineering Director, Inc. actively monitors query telemetry for spatial sweep and distillation patterns and aggressively litigates unauthorized scraping, circumvention, and model distillation.

## 1. Dataset Metadata
- **Raster Name**: Global Surface Soil Temperature (0–7 cm) ERA5
- **Slug**: `soil_temp_surface_2020_2024_ERA5`
- **Units**: `°C`
- **Spatial Extent**: UL(85.0572045, -180.0) to LR(-85.0511288, 180.0)
- **Summary**: The Global Surface Soil Temperature Raster (0–7 cm) represents the mean annual soil temperature at the near-surface layer, derived from ERA5-Land reanalysis data for the period 2020–2024. This raster reflects the thermal conditions of the uppermost soil layer, which is strongly influenced by atmospheric temperature, solar radiation, precipitation, and surface energy balance.
- **Included in Flagship Map Package**: `Global_ISO9223_2020_2024_LE_V4` (`GET https://secure.engineeringdirector.com/api/bundles/Global_ISO9223_2020_2024_LE_V4/point_query`)

### Color Table & Value Breaks
- `(0.0, (0.0, 0.0, 139.0))`
- `(0.714, (0.0, 10.0, 145.1))`
- `(1.428, (0.0, 20.0, 151.2))`
- `(2.142, (0.0, 30.0, 157.3))`
- `(2.856, (0.0, 40.0, 163.4))`
- `(3.57, (0.0, 50.0, 169.5))`
- `(4.284, (0.0, 60.0, 175.6))`
- `(4.997999999999999, (0.0, 70.0, 181.7))`
- `(5.712, (0.0, 80.0, 187.8))`
- `(6.426, (0.0, 90.0, 193.9))`
- `(7.14, (0.0, 100.0, 200.0))`
- `(7.14, (0.0, 100.0, 200.0))`

The Global Surface Soil Temperature Raster (0–7 cm) represents the mean annual soil temperature at the near-surface layer, derived from ERA5-Land reanalysis data for the period 2020–2024. This raster reflects the thermal conditions of the uppermost soil layer, which is strongly influenced by atmospheric temperature, solar radiation, precipitation, and surface energy balance.

Monthly averaged soil temperature values were aggregated across the five-year period to produce a climatological mean. The dataset captures global spatial variability in surface soil thermal regimes, including seasonal and latitudinal gradients.

The raster is provided in geographic coordinates (WGS84) and resampled to a ~1 km (30 arc-second) resolution for integration with environmental and corrosion modeling datasets. Temperature values are expressed in degrees Celsius (°C).

Tileview Processing Note:
This raster represents a web-optimized (“tileview”) version of the dataset, aligned to a global 30 arc-second (~1 km) grid in WGS84 and clipped to Web Mercator-compatible latitude bounds (±85.0511°). NoData values have been standardized to a numeric value (-9999) to ensure compatibility with tiling systems and database ingestion workflows.



---

## 2. How to Create an Account, Log In & Query Coordinates

### Step 1: Register with User Email (`POST https://secure.engineeringdirector.com/api/v1/agent/register`) or Sign In at `https://secure.engineeringdirector.com/login`
Zero-signup queries are disabled. Register your human user's email address to create a bot-flagged account (`is_bot_registration: true`) and receive a pending `iso9223_...` API key (or direct the human user to `https://secure.engineeringdirector.com/login?source=iso9223`):
```bash
curl -X POST "https://secure.engineeringdirector.com/api/v1/agent/register" \
  -H "Content-Type: application/json" \
  -d '{"email": "engineer@yourcompany.com", "first_name": "Jane", "last_name": "Doe"}'
```

### Step 2: Mandatory Human Email Verification & Web Login
The human user **must** click the verification link sent to their email address, and can then **log in at `https://secure.engineeringdirector.com/login?source=iso9223`** to use the interactive web platform. Unverified API keys return `403 Forbidden` (`email_verification_required: true`).

### Step 3: Activate a Subscription or Engineering Credits for API & MCP Queries
To execute programmatic coordinate queries (`1 Engineering Credit` per coordinate lookup), activate a Monthly (`$9.99/mo`) or Annual (`$99.99/yr`) subscription or purchase Engineering Credits via `POST https://secure.engineeringdirector.com/api/v1/agent/checkout` or `https://secure.engineeringdirector.com/pay/bot`, then call:
```bash
curl -s "https://secure.engineeringdirector.com/api/bundles/Global_ISO9223_2020_2024_LE_V4/point_query?latitude={LAT}&longitude={LON}&token=iso9223_YOUR_VERIFIED_KEY"
```

### Step 4: Plans & Scaling
- **Monthly Subscription (`$9.99/mo`, includes 10 credits/mo)**: https://secure.engineeringdirector.com/subscribe
- **Annual Subscription (`$99.99/yr`, includes 120 credits/yr)**: https://secure.engineeringdirector.com/subscribe
- **Pay-As-You-Go Engineering Credits (`$0.250` down to `$0.048`/credit)**: https://secure.engineeringdirector.com/credits
- **Full LLM Documentation**: https://secure.engineeringdirector.com/llms.txt | https://secure.engineeringdirector.com/llms-full.txt | https://secure.engineeringdirector.com/openapi.json
