Skip to main content

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 TypeDescriptionSource
Hosting CapacityPer-feeder electric distribution capacity, headroom, constraintsUtility ICA/DRP portals
SubstationsGeneration, demand, transformer ratings at distribution levelUtility APIs + HIFLD
Utility BoundariesGeographic service territory polygonsEIA Form 861
Transmission NetworkTransmission lines and substationsHIFLD (DHS)
EV RegistrationsElectric vehicle registrations by geographyState DMV data
Political BoundariesState, county, municipal polygonsUS Census
HexbinsH3 hexagon aggregations of circuits + EV dataProcessed 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​

ServiceDescription
Area QuerySpatial queries for hosting capacity within geographic areas
GeocodingAddress-to-coordinate resolution
Utility ResolverCoordinate-to-utility mapping (which utility services this location?)
VisualizationMap generation for distribution data

Map Layers​

The grid intelligence map composes layers in three bands, bottom to top:

  1. Background (DMV asset hexbins, transmission network) — context behind everything else.
  2. Network (distribution circuits, substations, hosting-capacity hexbins) — the grid you'd plan VPP capacity against.
  3. 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.