---
title: "Energy infrastructure near a location (sorted by distance)"
method: POST
path: "/api/osm-geo/infrastructure-nearby"
tags: ["OSM Geo (OpenStreetMap)"]
---

# Energy infrastructure near a location (sorted by distance)

`POST /api/osm-geo/infrastructure-nearby`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/osm-geo/infrastructure-nearby`
- Auth: none declared

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](https://opendatacommons.org/licenses/odbl/)

## Query parameters

- `token` string

## Request body

- object
  - `location` string: Coordinates as "lat,lon" string (e.g. "49.481,8.432").
  - `latitude` number: Latitude of the query centre.
  - `longitude` number: Longitude of the query centre.
  - `mastrNummer` string: MaStR number — coordinates resolved from local DB.
  - `radiusMeters` number: Search radius in metres (max 10 000).
  - `infraTypes` string[]: Filter by infrastructure type. Allowed: substation, transformer, line, cable.
  - `voltageLevel` string: Filter by voltage level: NS, MS, HS, EHS.
  - `maxResults` number: Maximum number of results.
  - `constrainToBbox` object: VNBDigital bounding box — objects outside are filtered out. Compatible with the bbox field from vnbdigital_lookup.
    - `north` number
    - `south` number
    - `east` number
    - `west` number
  - `include_geometry` boolean: Include GeoJSON geometry for lines/cables.
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Nearby infrastructure retrieved successfully

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)