OSM Geo (OpenStreetMap)

Geo-plausibility check for MaStR VNB assignment (L1 authoritative + L2 OSM)

Two-layer geographic plausibility check for the grid-operator assignment of a MaStR installation.

Layer 1 (authoritative): Coordinate → VNBDigital → expected grid operator for this location. Layer 2 (physical): Coordinate → Overpass API → nearby substations / dominant operator tag.

Detects both DEFINITIVE_MISASSIGNMENT (L1 mismatch, authoritative) and LIKELY_MISASSIGNMENT (L2 OSM hint only).

Input: either mastrNummer (coordinates resolved automatically) or explicit latitude + longitude.

Verdict values:

  • CONSISTENT — assignment plausible (L1 + L2 agree or no contradiction)
  • DEFINITIVE_MISASSIGNMENT — VNBDigital points to a different operator (authoritative correction required)
  • LIKELY_MISASSIGNMENT — OSM infrastructure tags suggest a different operator
  • UNCERTAIN — contradictory signals, no clear verdict
  • INSUFFICIENT_DATA — too few OSM objects for a reliable verdict

OSM coverage note: Typically 40–60 % of MS/NS infrastructure is mapped in OSM for Germany. The dataQuality.coverageLabel field carries a per-response quality estimate.

Data: © OpenStreetMap contributors, ODbL 1.0

post/api/osm-geo/validate

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/osm-geo/validate
  • Auth: none declared

Query parameters

tokenstring

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

mastrNummerstring

MaStR number (SEE…, SWE…, SBE…). Coordinates and VNB resolved automatically from the local DB.

latitudenumber

Latitude — required when mastrNummer is not provided.

longitudenumber

Longitude — required when mastrNummer is not provided.

registeredGridOperatorNamestring

Registered VNB name for the L1 comparison.

gridOperatorIdstring

MaStR ID of the VNB (SNB…).

radiusMetersnumber

OSM search radius in metres (max 5 000).

skipOsmLayerboolean

Only run L1 (no Overpass call). Faster for batch runs.

includeInfrastructureDetailsboolean

Include the full list of found OSM objects in the response.

confidenceThresholdnumber

Minimum score for CONSISTENT verdict.

tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "mastrNummer": "SEE900012345678",
  "latitude": 49.481,
  "longitude": 8.432,
  "registeredGridOperatorName": "STROMDAO Netze GmbH",
  "gridOperatorId": "SNB935578300972",
  "radiusMeters": 500,
  "confidenceThreshold": 40
}

Response

Validation result returned successfully

Changes

No recorded changes to this operation across all 2 revisions of this API.