Energy infrastructure near a location (sorted by distance)
Returns all energy infrastructure (substations, transformers, lines, cables) within a defined radius, sorted by distance from the query centre.
Each object carries voltage level, operator tag, and a connectionSuitability assessment:
- SUITABLE_NS — low-voltage connection suitable (≤ 400 V)
- SUITABLE_MS — medium-voltage connection suitable (1–20 kV)
- SUITABLE_HS — high-voltage connection (> 20 kV)
- LINE_ONLY — line/cable only, no node
- UNKNOWN — voltage level not determinable
Input: one of location (lat,lon string), latitude+longitude, or mastrNummer.
Use constrainToBbox (directly from a vnbdigital_lookup bbox field) to restrict results to the relevant grid territory.
Data: © OpenStreetMap contributors, ODbL 1.0
Request
- Base URL: https://api.cernion.de
- URL: https://api.cernion.de/api/osm-geo/infrastructure-nearby
- Auth: none declared
Query parameters
Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.
Request body
Example request
{
"location": "49.481,8.432",
"latitude": 49.481,
"longitude": 8.432,
"mastrNummer": "SEE900012345678",
"radiusMeters": 1000,
"infraTypes": [
"substation",
"transformer"
],
"voltageLevel": "NS",
"maxResults": 20,
"constrainToBbox": {
"north": 49.548,
"south": 49.427,
"east": 8.477,
"west": 8.298
}
}Response
Nearby infrastructure retrieved successfully
Changes
No recorded changes to this operation across all 2 revisions of this API.