Grid company and grid area (Elhub)

grid_company20 felter20 av feltene åpne i demoen

Kilde: Elhub energy data (Elhub AS, NLOD) via NVE Nettkonsesjonsområder
Geografi: Adressepunktet
Regnes som foreldet etter: 21 døgn
Tilgang: Krever API-nøkkel med tilgang til seksjonen
Kontraktversjon: 1
I pakkene: planning_restrictions

Hva dette ikke sier

Gjengitt ordrett fra seksjonens warnings-felt, slik API-et returnerer det. Vi oversetter dem ikke: en oversettelse ville vist noe annet enn det svaret ditt faktisk inneholder.

The grid company is found by organisation number: NVE's concession polygon at the address names the holder (concession_holder_org_number), and Elhub's register names the grid owner with that number (grid_company_*). Nothing is matched on names. elhub_match says why a step stopped: no_unambiguous_concession_polygon (the address lies outside NVE's generalised polygons and the nearest one is either over 2 km away or not clearly nearer than another holder's), or concession_holder_not_an_active_elhub_grid_owner (NVE's layer still names a company since merged into another; the successor is not inferred).
concession_match is inside_concession_polygon, or nearest_concession_polygon with concession_distance_m when NVE's coastline generalisation left the address just outside every polygon; the nearest is used only within 2 km and when no other holder's polygon lies within 1 km beyond it.
A grid company can operate several grid areas (nettområder). grid_area_id is set only when the company has one active grid area, or exactly one of them lies in the price zone of NVE's elspot polygon at the address (nve_price_zone); otherwise grid_area_resolution is ambiguous and candidate_grid_areas lists the company's active areas. price_area follows the grid area, or the company when all its areas share one price area, or NVE's elspot zone at the address when the company has a grid area in that zone (price_area_resolution says which); otherwise it is null. The tariff (nettleie) is not included.
Grid areas and grid owners: Elhub energy data (Elhub AS), Norsk lisens for offentlige data (NLOD). Concession polygons and price zones: NVE, NLOD.

Felter

6 av 20 felter er verdifelter — de som avgjør om en post faktisk sier noe. Resten er kontekst: identifikatorer, koder og tidsstempler. Feltene merket «åpen» returnerer verdier til anonyme kallere; de øvrige krever nøkkel.

Felt	Type	Rolle	Demo
concession_holder_name	string \| null	kontekst	åpen
concession_holder_org_number	string \| null	kontekst	åpen
concession_holder_type	string \| null	kontekst	åpen
concession_match	string \| null	kontekst	åpen
concession_distance_m	integer \| null (m)	kontekst	åpen
elhub_match	string \| null	kontekst	åpen
grid_company_name	string \| null	verdi	åpen
grid_company_org_number	string \| null	verdi	åpen
active_grid_areas	integer \| null	kontekst	åpen
grid_area_id	string \| null	verdi	åpen
grid_area_name	string \| null	verdi	åpen
grid_area_eic	string \| null	kontekst	åpen
grid_company_gln	string \| null	kontekst	åpen
grid_area_resolution	string \| null	kontekst	åpen
candidate_grid_areas	array<object> \| null	verdi	åpen
price_area	string \| null	verdi	åpen
price_area_resolution	string \| null	kontekst	åpen
price_area_eic	string \| null	kontekst	åpen
nve_price_zone	string \| null	kontekst	åpen
fetched_at	timestamp \| null	kontekst	åpen

Hent denne seksjonen

curl -H "X-API-Key: $APPROACH_API_KEY" \
  "https://api.approach.no/api/v1/addresses/285717643?include=grid_company"

# paginated, one section at a time
curl -H "X-API-Key: $APPROACH_API_KEY" \
  "https://api.approach.no/api/v1/addresses/285717643/sections/grid_company?limit=25"

Prøv den nå

Dette er et ekte kall mot den offentlige demoen, herfra. Svaret under er det API-et returnerte — ikke et eksempel.