Nearby Infrastructure
get_infrastructureRead-onlyIdempotent
Find nearby energy infrastructure (substations, transmission lines, gas pipelines, power plants) within a radius of any location, with distances and capacities.
Instructions
Nearby infrastructure for a location — substations (count + max voltage_kv within radius), transmission lines (>69 kV path overlay), interstate + lateral gas pipelines, and power plants (operating + planned, by fuel) within configurable radius_km. Returns distance + capacity for each, joined to HIFLD/EIA. Try: get_infrastructure lat=33.45 lon=-112.07 radius_km=25. Returns raw nearby assets; do NOT use for a single scored site-suitability verdict (use analyze_site).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Center latitude in decimal degrees (-90 to 90, required), e.g. 33.45 | |
| lng | No | Alias for lon — either name works | |
| lon | No | Center longitude in decimal degrees (-180 to 180, required), e.g. -112.07 | |
| layer | No | Optional single asset layer to return, e.g. substations, transmission, pipelines, power_plants | |
| limit | No | Max results to return (1-500; default varies by tool) | |
| latitude | No | Alias for lat — either name works | |
| longitude | No | Alias for lon — either name works | |
| radius_km | No | Search radius in kilometers around the point, e.g. 25 | |
| min_voltage_kv | No | Only include transmission/substations at or above this voltage in kV, e.g. 69 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quota | No | Caller quota state (remaining calls, tier) when available. | |
| _entity | No | Payload class discriminator (e.g. facility|market|iso_grid|queue_results|deal|report|response) — branch on this before parsing the rest. | |
| citation | No | Machine-readable citation: how to attribute DC Hub (dchub.cloud) for this payload. Normally an OBJECT {source, url, license, cite_as, retrieved_at}; a bare string is accepted and carries the attribution line itself. | |
| provenance | No | Collection-level provenance block: {source, method, as_of, verification_counts, cite_url_template, license, cite_as}. Quote the verification level when citing. | |
| _front_door | No | In-band front-door hint (first workflow-entry tool of a session): call plan_query(intent) first for the ordered multi-step plan. | |
| _return_loop | No | Suggested next-session delta call (get_changes since=24h) so you pull only what changed. | |
| site_evaluation_handoff | No | Pre-built follow-up calls (analyze_site / get_water_risk args) when the payload carries coordinates — an array of {tool, parameters, why} entries. |