Grid Infrastructure Data (Gridbase)
Module:
insight(always on) | Role: Any member | Licence: Free+
Gridbase is the platform's energy infrastructure reference data layer. It normalizes and stores grid-level data from utility APIs, federal databases, and processed aggregations.
What Gridbase Stores
| Data Type | Description | Source |
|---|---|---|
| Hosting Capacity | Per-feeder electric distribution capacity, headroom, constraints | Utility ICA/DRP portals |
| Substations | Generation, demand, transformer ratings at distribution level | Utility APIs + HIFLD |
| Utility Boundaries | Geographic service territory polygons | EIA Form 861 |
| Transmission Network | Transmission lines and substations | HIFLD (DHS) |
| EV Registrations | Electric vehicle registrations by geography | State DMV data |
| Political Boundaries | State, county, municipal polygons | US Census |
| Hexbins | H3 hexagon aggregations of circuits + EV data | Processed from above |
Coverage
17 utility adapters covering 53,818 circuits and 4,249 substations across:
- California: PG&E, SDG&E, SCE
- New York: ConEd, NYSEG, RG&E, PSEG Long Island, Orange & Rockland, Central Hudson
- New England: Eversource CT/MA/NH, United Illuminating
- Mid-Atlantic & Other: National Grid MA, BGE, PEPCO, Xcel Energy
See Supported Utilities for the full adapter registry and data completeness matrix.
Key Design Principles
- All units normalized to MW — adapters receiving kW convert on ingest
- All coordinates normalized to WGS84 — Web Mercator converted automatically
- All data files gzipped — compressed storage for efficient loading
- Dynamic utility discovery — derived from adapter registry + HIFLD fallback
Services
| Service | Description |
|---|---|
| Area Query | Spatial queries for hosting capacity within geographic areas |
| Geocoding | Address-to-coordinate resolution |
| Utility Resolver | Coordinate-to-utility mapping (which utility services this location?) |
| Visualization | Map generation for distribution data |
Map Layers
The grid intelligence map composes layers in three bands, bottom to top:
- Background (DMV asset hexbins, transmission network) — context behind everything else.
- Network (distribution circuits, substations, hosting-capacity hexbins) — the grid you'd plan VPP capacity against.
- Workspace data (Known charging sites, future user-data layers) — the highest-prominence band, so your own evidence reads above the network context.
"Known charging sites" appears when your workspace has the platform:holistics module enabled AND a user has connected their personal Holistics integration (Profile → Integrations). It renders dots for every location where one or more drivers in the connecting user's Holistics scope has at least one recorded charging session. Visible at city zoom and above.
When you click a substation, the asset bar at the bottom is the single source of truth for customer-side counts (homes, EVs, solar, batteries, thermostats, public chargers). The values are pro-rated from utility totals to the substation's capacity share, with the methodology shown in the bar's note. The hover tooltip on the substation marker shows grid-intrinsic data only — voltage, capacity, available MW, demand, circuits — and never duplicates the asset bar.
Related Documentation
- Hosting Capacity Data & Methodology — ICA data sources, coverage, deferral financial assumptions
- Supported Utilities — Full adapter registry, data completeness, field availability
- Integrations — Holistics setup for the "Known charging sites" layer