Hopp til innhold

ADRESSE-API · OBSERVASJONER

Målinger ved adressen over tid

Profilen sier hva nærmeste tellepunkt eller værstasjon målte sist. Observasjonene sier hva den har målt over tid: timeverdier, døgn og måneder, eller profiler for ukedag og time og for måned i året. Verdiene kommer alltid fra nærmeste stasjon innenfor variabelens radius, med navn og avstand, aldri fra en stasjon lenger unna.

API-versjon
1.19.1
Variabler
6
Punkter per kall
10 000
Innhold

Hva du får

  • grain=hour, day eller month med from og to. Uten periode får du de siste 7 døgnene med timer, 90 døgn med døgn eller 24 måneder med måneder. Døgn og måneder følger norsk tid.
  • profile=hour_weekday (168 celler), hour_of_day (24) eller month_of_year (12) i stedet for punkter: snitt, 10- og 90-persentil og antall målinger bak hver celle.
  • Hvert punkt har quality: measured, estimated (en delvis time eller en periode med hull) eller missing. En time uten verdi er ukjent, ikke null.
  • Timeverdier lagres i 92 døgn, månedsverdier i fem år. span_available sier hvor langt tilbake serien går.
  • Finnes ingen stasjon innenfor radiusen, svarer API-et status: not_found med reason: no_station_within_range.
  • Endepunktet slås på miljø for miljø. Oversikten på GET /api/v1 lister observasjoner når de er tilgjengelige.

Variabler

Tilgangen til en variabel følger seksjonen den hører til: en nøkkel uten weather får heller ikke temperatur som tidsserie. https://api.approach.no/api/v1/addresses/observations/catalog

IdHva og fra hvorEnhetRadiusOppløsning og profilerSeksjon
trafficTrafikkmengde ved nærmeste tellepunkt
tellepunkt · Statens vegvesen (Trafikkdata) · NLOD 2.0
vehicles/h2 kmtime, døgn, måned · time på døgnet, ukedag × time, måned i åretnearest_traffic_sensors
temperatureLufttemperatur ved nærmeste værstasjon
målestasjon · Meteorologisk institutt (Frost) · NLOD 2.0 / CC BY 4.0
degC30 kmtime, døgn, måned · time på døgnet, ukedag × time, måned i åretweather
windVindstyrke og vindretning ved nærmeste værstasjon
målestasjon · Meteorologisk institutt (Frost) · NLOD 2.0 / CC BY 4.0
m/s · retning degrees30 kmtime, døgn, måned · time på døgnet, ukedag × time, måned i åretweather
precipitationNedbør ved nærmeste værstasjon
målestasjon · Meteorologisk institutt (Frost) · NLOD 2.0 / CC BY 4.0
mm (sum per periode)30 kmtime, døgn, måned · time på døgnet, ukedag × time, måned i åretweather
water_levelVannstand ved nærmeste målestasjon (NVE)
målestasjon · NVE (HydAPI) · NLOD 2.0
m10 kmtime, døgn, måned · time på døgnet, ukedag × time, måned i åretnearby_water_level
air_qualityLuftkvalitet (varsel) ved adressen
varsel · Meteorologisk institutt (Luftkvalitetsvarsel) · NLOD 2.0 / CC BY 4.0
AQIved adressentimeair_quality_forecast

Oppslag og pris

Observasjoner inngår i oppslaget for adressen. Samme adresse samme dag (norsk tid) er ett oppslag, uansett hvor mange variabler, perioder og seksjoner du henter. Et kall gir høyst 10 000 punkter; en større periode avvises med observation_range_too_large før noe leses eller telles. Trenger du mer, er tidsserie-API-et og dataproduktene laget for store uttrekk. Priser

Eksempler

Samme kodebygger som Prøv API-et på kontosiden, så det du kopierer her er kallet du ville kjørt der.

curl --disable --fail-with-body --silent --show-error --connect-timeout 10 --max-time 30 \
  -H "X-API-Key: ${APPROACH_API_KEY:?APPROACH_API_KEY is not set}" \
  'https://api.approach.no/api/v1/addresses/285717643/observations/traffic'

Endepunkter

https://api.approach.no/api/v1/addresses

GET

/{address_id}/observations/{variable}

Les en målt variabel ved adressen som tidsserie. traffic, temperature, wind, precipitation og water_level fra nærmeste tellepunkt eller målestasjon innenfor variabelens radius (trafikk 2 km, vær 30 km, vannstand 10 km), og air_quality fra METs varsel. grain=hour|day|month med from/to, eller profile=hour_of_day|hour_weekday|month_of_year for profilen; format=json|csv. Høyst 10 000 punkter per kall. Inngår i oppslaget for adressen: samme adresse samme dag (Oslo-tid) er ett oppslag, uansett hvor mange variabler og seksjoner som hentes. Variabelens profilseksjon må være med i tilgangen. Ingen stasjon innenfor radiusen gir not_found med reason no_station_within_range, aldri en stasjon lenger unna.

Parametere

NavnTypeGrenser og standardBeskrivelse
address_id
sti · påkrevd
string^[0-9]{1,18}$—
variable
sti · påkrevd
stringtraffic | temperature | wind | precipitation | water_level | air_quality—
grain
spørring
stringhour | day | monthDefault: the variable's native grain (hour).
from
spørring
string—Inclusive. Default: 7 days before to for hours, 90 days for days, 24 months for months.
to
spørring
string—Exclusive. Default: the end of the current hour, day or month.
profile
spørring
stringhour_of_day | hour_weekday | month_of_yearReturn the rollup instead of points; takes none of grain, from and to.
format
spørring
stringjson | csv
standard json
—

string——

Svar og feilkoder

HTTPBetydningKoder i svaret
200The series, or not_found with a reason when no station is within range. CSV is one row per point or profile cell.—
400Unknown variable, unavailable grain or profile, invalid or too large window, or an unsupported parameter
401Authentication required
402Account request allowance exhausted
403Observations endpoint or the variable's section not granted
404Address not found
429Rate limit exceeded; see Retry-After
500—
503Observation store or forecast source unavailable; nothing was counted
Eksempel på kall
curl --disable --fail-with-body --silent --show-error --connect-timeout 10 --max-time 30 \
  -H "X-API-Key: ${APPROACH_API_KEY:?APPROACH_API_KEY is not set}" \
  'https://api.approach.no/api/v1/addresses/285717643/observations/traffic?grain=day&from=2026-07-01&to=2026-10-01'
GET

/observations/catalog

uten nøkkel

List observasjonsvariablene. Hver variabel med enhet, profilseksjonen som gir tilgang, radius, oppløsninger, profiler, hvordan timer slås sammen til døgn og måneder, kilde og lisens. Krever ingen nøkkel.

Parametere

NavnTypeGrenser og standardBeskrivelse

string——

Svar og feilkoder

HTTPBetydningKoder i svaret
200The variables.—
Eksempel på kall
curl 'https://api.approach.no/api/v1/addresses/observations/catalog'