# Distance to River (`Distance_To_River_20km_Geodesic`) — 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**: Distance to River
- **Slug**: `Distance_To_River_20km_Geodesic`
- **Units**: `Meters (m)`
- **Spatial Extent**: UL(90.125, -180.0) to LR(-90.1219617, 180.1247159)
- **Summary**: The Distance to River raster provides the geodesic distance (in meters) from each location to the nearest mapped river channel. This metric is used to quantify hydrologic connectivity and proximity to flood-prone environments.
- **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`)


<h2>Technical Specifications</h2>

<h3>Distance to River (Geodesic)</h3>
<p><strong>Global | ~1 km Resolution</strong></p>

<h4>Raster Name</h4>
<p>Distance to River – Geodesic Distance</p>

<h4>File Name</h4>
<p>Distance_To_River_20km_Geodesic.tif</p>

<h4>Short Description</h4>
<p>
A global raster representing the geodesic (true surface) distance from each location to the nearest mapped river channel, used as a foundational input for hydrologic connectivity and river influence modeling.
</p>
<h4>How to Read This Map</h4>
<ul>
  <li>This map represents <strong>distance from the nearest river</strong></li>
  <li>Values increase as you move away from river channels</li>
  <li>Near-field proximity is <strong>most relevant for interpretation</strong></li>
  <li>Far-field areas have <strong>minimal impact on hydrologic exposure</strong></li>
</ul>

<p><strong>Key Insight:</strong> Only locations near rivers meaningfully contribute to hydrologic exposure.</p>
<h4>Units of Measure</h4>
<p>Meters (m)</p>

<h4>Technical Specification</h4>
<p>
The Distance to River raster quantifies the shortest geodesic distance from each grid cell to the nearest identified drainage channel within the global hydrologic network.
</p>

<p>
Distances are calculated using spherical geometry (geodesic measurement) to ensure spatial accuracy across the globe, particularly at high latitudes.
</p>

<p>
This raster serves as the base input for proximity-based hydrologic modeling and is directly used to derive the River Influence (Distance-Based Decay) layer.
</p>

<h4>Key Characteristics</h4>

<ul>
  <li>Represents true surface distance to nearest river channel</li>
  <li>Calculated using geodesic (earth curvature-aware) methods</li>
  <li>Higher values indicate increasing distance from drainage systems</li>
  <li>Lower values indicate proximity to rivers and hydrologic connectivity</li>
  <li>Primary input for river influence modeling</li>
</ul>

<h4>Spatial Characteristics</h4>

<ul>
  <li><strong>Coordinate System:</strong> GCS_WGS_1984</li>
  <li><strong>Spatial Resolution:</strong> ~1 km</li>
  <li><strong>Coverage:</strong> Global</li>
  <li><strong>Format:</strong> GeoTIFF / web raster</li>
</ul>

<h4>Processing</h4>

<p>
The Distance to River raster was derived using global drainage network data and geodesic distance calculations.
</p>

<ul>
  <li>River channels identified from upstream contributing area thresholds</li>
  <li>Global drainage network extracted from hydrologic datasets</li>
  <li>Geodesic distance calculated from each grid cell to nearest river</li>
  <li>Distance values stored in meters</li>
  <li>Output clipped and formatted for web-based raster applications</li>
</ul>

<h4>Interpretation</h4>

<table border="1" cellpadding="6" cellspacing="0">
  <tr>
    <th>Distance</th>
    <th>General Interpretation</th>
  </tr>
  <tr>
    <td>0 – 500 m</td>
    <td>Immediately adjacent to river channels; high hydrologic connectivity</td>
  </tr>
  <tr>
    <td>500 m – 5 km</td>
    <td>Within floodplain or near-river influence zone</td>
  </tr>
  <tr>
    <td>5 km – 20 km</td>
    <td>Moderate proximity to river systems</td>
  </tr>
  <tr>
    <td>&gt; 20 km</td>
    <td>Distant from major drainage systems; limited river influence</td>
  </tr>
</table>

<h4>Role in Pipeline Hydrologic Exposure Model</h4>

<p>
The Distance to River raster is a foundational input used to quantify proximity to drainage systems and support hydrologic connectivity modeling.
</p>

<p>
It directly supports:
</p>

<ul>
  <li>River Influence (Distance-Based Decay)</li>
  <li>Saturation Potential Index</li>
  <li>Pipeline Hydrologic Exposure Score (1–100)</li>
  <li>Pipeline Hydrologic Exposure Index (1–7)</li>
</ul>

<p>
Shorter distances correspond to increased likelihood of:
</p>

<ul>
  <li>Floodplain influence</li>
  <li>Groundwater interaction</li>
  <li>Periodic or persistent saturation</li>
</ul>

<h4>Scope and Intended Use</h4>

<ul>
  <li>River proximity analysis</li>
  <li>Hydrologic connectivity assessment</li>
  <li>Pipeline exposure and corrosion screening</li>
  <li>Supporting input for terrain-based hydrologic models</li>
  <li>Environmental and geospatial analysis</li>
</ul>

<p>
This dataset is intended as a base measurement layer and should be interpreted in combination with derived indices such as River Influence and Saturation Potential.
</p>

<h4>Related Hydrologic Exposure Datasets</h4>

<h5>Primary Hydrologic Exposure Indices</h5>

<ul>
<li><a href="https://secure.engineeringdirector.com/public/map/Pipeline_Hydrologic_Exposure_Score_1_100_v14_final">Pipeline Hydrologic Exposure Score (1–100)</a></li>
<li><a href="https://secure.engineeringdirector.com/public/map/Pipeline_Hydrologic_Exposure_Index_1_7_v14_INT_websafe">Pipeline Hydrologic Exposure Index (1–7)</a></li>
</ul>

<h5>Supporting Hydrologic Input Layers</h5>

<ul>
  <li><a href="https://secure.engineeringdirector.com/public/map/HAND_Height_Above_Nearest_Drainage_m">HAND – Height Above Nearest Drainage</a></li>
  <li><a href="https://secure.engineeringdirector.com/public/map/HAND_Low_Lying_Index_0_1">HAND Low-Lying Index</a></li>
  <li><a href="https://secure.engineeringdirector.com/public/map/Saturation_Potential_Index_0_1">Saturation Potential Index</a></li>
  <li><a href="https://secure.engineeringdirector.com/public/map/Drainage_Position_Index_0_1">Drainage Position Index</a></li>
  <li><a href="https://secure.engineeringdirector.com/public/map/River_Influence_20km">River Influence</a></li>
  <li><a href="https://secure.engineeringdirector.com/public/map/Distance_To_River_20km_Geodesic">Distance to River</a></li>
  <li><a href="https://secure.engineeringdirector.com/public/map/Drainage_Index_Normalized_0_1">Drainage Intensity Index</a></li>
</ul>

<h4>Limitations</h4>

<ul>
  <li>This dataset measures distance only and does not represent flow magnitude or water volume.</li>
  <li>It does not account for seasonal variation, flooding events, or hydrologic timing.</li>
  <li>It does not include engineered drainage systems or infrastructure.</li>
  <li>Distance alone does not determine hydrologic exposure and must be used with other indices.</li>
</ul>

<h4>Legal & Licensing</h4>

<p>
© 2026 AtmosphericIQ LLC and Engineering Director, Inc. All rights reserved.
</p>

<p>
This dataset and associated models are proprietary to AtmosphericIQ LLC and distributed by Engineering Director, Inc.
</p>

<h4>Dataset Citation</h4>

<p>
Mazzella, J. (2026).<br>
<strong>Distance to River (Geodesic), Global Raster.</strong><br>
AtmosphericIQ LLC / Engineering Director, Inc.
</p>

<p>
Derived using global drainage network extraction and geodesic distance calculations from terrain-based hydrologic datasets.
</p>

---

## 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