API-dokumentasjon
Referanse for api.solkart.no: solprognose, PV-produksjon, TMY, snøtap, sol og horisont, stedlig snølast, terrengkategori og takanalyse for punkter i Norge. Parametre, svar, feil og kvoter, hentet fra koden som kjører.
Solkart-API-et gir deg de samme beregningene som verktøyene på solkart.no, som JSON, CSV og fagformater over HTTPS. Alle endepunkter tar et punkt i Norge (WGS84 breddegrad og lengdegrad) og svarer med tall du kan bruke direkte i egne systemer. Base-URL er https://api.solkart.no. Ny her? Start på Kom i gang, som tar deg fra nøkkel til første kall på ett minutt.
Slik er dokumentasjonen bygd opp
1. Grunnlag Nøkler, kvoter, feilformat, tid og enheter, asynkrone jobber, caching og versjonering. Les disse én gang.
2. Ett produkt per side Hver side har parametertabell, eksempel på forespørsel og ekte svar, feil du kan få, og kobling til verktøyet i nettleseren.
3. Maskinlesbart OpenAPI 3.1 for kodegenerering og llms-full.txt for KI-assistenter. Hver side finnes også som Markdown.
Alle endepunkter
| Endepunkt | Gir | Nøkkel | Side |
|---|---|---|---|
GET/POST /api/forecast |
Solinnstråling og PV-produksjon time for time, om lag 60 timer frem | Valgfri (IP-kvote uten) | Solprognose |
POST /api/forecast/bulk |
Samme for inntil 50 anlegg i ett kall | Valgfri | Solprognose |
GET/POST /api/forecast/extended |
Prognose ut til 10 døgn | Basic eller høyere | Solprognose |
GET /api/forecast/nowcast |
Satellittbasert nowcast 0 til 3 timer | Valgfri | Solprognose |
GET /api/forecast/latest |
Metadata om siste prognosesyklus | Nei | Solprognose |
GET /api/pv/calc |
Års- og månedsproduksjon for et anlegg (TMY-basert) | Nei | PV-produksjonsberegning |
GET /api/tmy |
Typisk meteorologisk år, 8760 timer, 15 formater | Valgfri (IP-kvote uten) | TMY Norge |
GET /api/tmy/stats, /api/tmy/sources |
Årssummer, P-verdier, valgte år og kilder per celle | Valgfri | TMY Norge |
GET /api/snowsoiling/calc |
Snø- og smusstap per måned for et anlegg | Nei | Snøtap |
GET /api/snow/outlook |
Snødekning på panelet neste 10 døgn | Nei | Snøtap |
GET /api/horizon/terrain |
Terrenghorisont, 720 asimutpunkter | Nei | Sol og horisont |
POST /api/horizon/rooftop, /api/horizon/precise |
Horisont fra takhøyde med nærfelt (DOM 1 m) | Nei i pilot | Sol og horisont |
GET /api/snowload/calc |
Stedlig karakteristisk snølast (NS-EN 1991-1-3 NA.4.1(2)) | Nei | Stedlig snølast |
POST /api/terrain/category, /api/terrain/jobs |
Terrengkategori og terrengform per sektor (NS-EN 1991-1-4 NA) | Nei i pilot | Terrengkategori |
POST /api/roof/jobs, /api/roof/layout |
Modulplassering og kWp på et tak fra flyfoto og høydemodell | Avtale (passord) | Takanalyse |
POST /api/register |
Opprett gratis API-nøkkel | Nei | Autentisering |
GET /health |
Helsesjekk | Nei | Kvoter, grenser og feil |
Tre ting du bør vite før første kall
- Tidsstempler er starten på timen, i UTC. En verdi merket
10:00:00Zgjelder perioden 10:00 til 11:00 UTC. Se konvensjoner. - Kvoten telles i «anlegg», ikke bare i kall. Ett anlegg er én unik koordinat per døgn. Samme koordinat kan spørres om mange ganger. Se kvoter, grenser og feil.
- Feil kommer alltid som JSON med feltet
errorog en norsk forklaring, og med riktig HTTP-status. Endepunktene for horisont, terreng og tak legger til en maskinlesbarcode.
Grunnlag
Autentisering og API-nøklerHvordan du får en API-nøkkel, hvordan du sender den, hvilke endepunkter som krever den, og hvordan du oppbevarer den trygt.
POST /api/registerKvoter, grenser og feilPlaner og kvoter, hva et «anlegg» er, hvor raskt du kan kalle hvert endepunkt, og hvordan feilsvar ser ut med status, error og code.GET /healthKonvensjoner: tid, enheter og koordinaterTidsstempler (bin-start, UTC), enheter, asimut- og helningskonvensjoner per endepunkt, koordinatsystemer, dataformater og HTTP-detaljer som gjelder på tvers av API-et.Asynkrone jobberTerrengkategori og takanalyse kan ta opptil et par minutter. Jobbendepunktene legger analysen i kø og lar deg hente status og resultat når den er ferdig.POST /api/terrain/jobsCaching, versjonering og utfasingHvor ofte data endres, hvilke Cache-Control-hoder hvert endepunkt setter, hvordan du finner ut hvilken modellversjon du fikk, og hva som fases ut når.Sol og energi
SolprognoseSolinnstråling (GHI) og PV-produksjon time for time, 60 timer frem, for ethvert punkt eller anlegg i Norge. Bulk for inntil 50 anlegg, utvidet prognose til 10 døgn, satellittbasert nowcast og metadata om siste syklus.
GET /api/forecastPV-produksjonsberegningForventet års- og månedsproduksjon for et solcelleanlegg hvor som helst i Norge, regnet på TMY Norge med terrenghorisont. Flere takflater, klipping, snøtap, P50 til P95 og optimal vinkel. Samme beregning som PVGIS, med norske data.GET /api/pv/calcTMY NorgeTypisk meteorologisk år for ethvert punkt på fastlands-Norge, 8760 timer med GHI, DNI, DHI, temperatur, fukt, vind og trykk. 15 filformater, fire produkter, P50 til P95, statistikk og kilder per celle.GET /api/tmySnøtap for solcellerStedlige snø- og smusstap per måned for et solcelleanlegg, samme modell som NS 3031:2025-tabellene bygger på, kjørt med lokale seNorge-data for din helning og montasje. Pluss snødekning på panelet neste 10 døgn.GET /api/snowsoiling/calcSol og horisontHorisontprofil i 720 retninger for et punkt i Norge, i tre nivåer: terreng fra DTM10 (gratis, uten nøkkel), fra takhøyde med nærfelt fra DOM 1 m, og presis analyse med skyggetap, PDF og CSV. Eksport til PVsyst, PV*SOL, SAM, HelioScope og Meteonorm.GET /api/horizon/terrainTakanalyseModulplassering, antall moduler og kWp for et tak fra bygningsomriss (FKB), høydemodell 1 m og flyfoto med SunPoint bildeanalyse. Skråtak og flate tak, øst/vest eller sør, avstander etter NEK 400-7-712, tegning som PNG og GeoJSON. Krever avtale.POST /api/roof/jobsBygg og konstruksjon
Stedlig snølastKarakteristisk snølast på mark for en tomt, regnet etter SINTEF-metoden (alternativ metode i NS-EN 1991-1-3 NA.4.1(2)) på NVEs seNorge-serie fra 1957, med sammenligning mot Eurokodens kommunetabell. JSON eller CSV, ingen nøkkel.
GET /api/snowload/calcTerrengkategori og terrengformTerrengruhetskategori etter NS-EN 1991-1-4:2005/NA:2009 for et punkt, fastsatt retningsvis i 72 sektorer ut til 10 km fra Kartverkets høydemodeller, FKB-bygninger og NIBIO AR5, med overgangssoner, kontrollpunkter, terrengformfaktor c_o etter NA.4.3.3 og RIB-overstyring. JSON, PDF eller HTML. Beta.POST /api/terrain/category