Velkommen til Flomvarsel API

Innhold

1 Introduksjon

Flomvarsel API er basert på REST. Det leverer data som XML og JSON (standard). Kun GET er støttet.

Dataene er fritt tilgjengelige for bruk.

2 Versjoner

Det vil komme nye versjoner av APIet, så det er et versjonsnummer i lenken. Vi lar gamle versjoner leve minst 6 måneder før de blir slettet uten forvarsel.

2.1 Prod versjoner

Her er vår presentasjon av dataene: http://www.varsom.no/Flom/

2.2 Test versjon

Vi har en test versjon som kan brukes for å teste mot. Denne blir oppdatert uten forvarsel. Og vil alltid inneholde de siste endringene.
Testversjon:

Her er vår presentasjon av test dataene: http://beta.varsom.no/flom-og-jordskredvarsling/

3 Hvordan bruke API'et

3.1 Format

API'et leverer data på to formater, XML og JSON. JSON er standard format om ikke noe er spesifisert. Man spesifiserer ved å sette Accept i request header.

Accept:
3.2.1 Swagger

For å teste API'et kan man bruke swagger: http://api01.nve.no/hydrology/forecast/flood/test/swagger/ui/index#/

3.2.2 Urlformat

3.3 Hent metode

3.3.1 CountyOverview

CountyOverview inneholder en liste med alle fylker, som inneholder kun de kommunene som inneholder et varsel med aktsomhetsnivå fra 2 og over. Og man kan spesifisere datoene.
Eks: http://api01.nve.no/hydrology/forecast/flood/v1.0.4/api/CountyOverview/1

3.3.2 CountySummary

CountySummary inneholder en liste med alle fylker og alle kommuner innen hvert fylke. Hver kommune inneholder det antall varsler som er spesifisert av datoene.
Eks: http://api01.nve.no/hydrology/forecast/flood/v1.0.4/api/CountySummary/1

3.3.3 EmergencyWarning

EmergencyWarning inneholder en liste med beredskapsmeldinger. Man kan spesifisere datoene. Kun ment for varsom.no
Eks: http://api01.nve.no/hydrology/forecast/flood/v1.0.4/api/EmergencyWarning/1

3.3.4 MapComments

MapComments inneholder en liste med prognosekart kommentarer. Man kan spesifisere datoene. Kun ment for varsom.no
Eks: http://api01.nve.no/hydrology/forecast/flood/v1.0.4/api/MapComments/1

3.3.5 Region

Region inneholder en liste over alle fylker og tilhørende kommuner. Man kan spesifisere fylket med Id.
Eks: http://api01.nve.no/hydrology/forecast/flood/test/api/Region/

3.3.6 Warning

Warning inneholder en liste med varsler basert på et fylke, kommune, eller Id. Eller man kan hente alle varsler, eller bare de varslene som er skrevet. Man kan spesifisere datoene.
Eks:

3.3.7 WarningByCounty

WarningByCounty inneholder varsler basert på et fylkesnummer eller fylkesnavn. Man kan spesifisere datoene.
Eks:

3.3.8 WarningByMunicipality

WarningByMunicipality inneholder varsler basert på et kommunenummer. Man kan spesifisere datoene.
Eks: http://api01.nve.no/hydrology/forecast/flood/v1.0.4/api/WarningByMunicipality/0929/1/

3.4 Språknøkkel

Leveres foreløpig kun på norsk.
Norsk = 1

3.5 Dato spesifisering. (startdato/sluttdato)

Hvis man ikke spesifiserer dato, får man tre varsler, idag, i morgen og over i morgen.
http://api01.nve.no/hydrology/forecast/flood/v1.0.4/api/WarningByMunicipality/0929/1/

Hvis man spesifiserer bare startdato, får man tre varsler, fra datoen som er spesifisert og to dager frem:
http://api01.nve.no/hydrology/forecast/flood/v1.0.4/api/WarningByMunicipality/0929/1/2013-11-03/

Hvis man spesifiserer start- og sluttdato, får man varslene for de datoene:
http://api01.nve.no/hydrology/forecast/flood/v1.0.4/api/WarningByMunicipality/0929/1/2013-11-03/2013-11-03/

3.6 Dato og tidsspesifisering. (dato/tid)

Hvis man ikke spesifiserer dato og tid, blir det dagens dato fra 00:00.
http://api01.nve.no/hydrology/forecast/flood/v1.0.4/api/GetlastVersionOfAllUpdatesAfterDateTime/1/

Hvis man ikke spesifiserer tid, blir det fra 00:00. (Eksempelet under henter kun i dag)
http://api01.nve.no/hydrology/forecast/flood/v1.0.4/api/GetlastVersionOfAllUpdatesAfterDateTime/1/2016-03-29/

Hvis man spesifiserer dato og tid får man alle oppdateringer etter dette tidspunktet. (Eksempelet under henter kun i dag)
http://api01.nve.no/hydrology/forecast/flood/v1.0.4/api/GetlastVersionOfAllUpdatesAfterDateTime/1/2016-03-29/1300

4 Gyldige verdier

4.1 ExposedHeightValue

Kan ha verdier fra 0 - 2500

4.2 ExposedHeightType

4.3 ExposedClimateType (Ikke i bruk)

4.4 Diverse dataverdier

Cause
ActivityLevel

5 Eksempel XML

FloodWarning

Inneholder alle datafelter et varsel kan ha. FloodWarning arver fra Warning, og derfor blir typen slik <Warning i:type="FloodWarning">

<Warning i:type="FloodWarning">
	<Id>8962</Id>
	<EventId>8962</EventId>
	<MasterId>8962</MasterId>
	<Version>1</Version>
	<ValidFrom>2013-11-11T00:00:00</ValidFrom>
	<ValidTo>2013-11-11T23:59:00</ValidTo>
	<NextWarningTime>2013-11-11T22:00:00</NextWarningTime>
	<PublishTime>2013-11-11T09:43:00</PublishTime>	
	<ActivityLevel>4</ActivityLevel>
	<ActivityLevelName i:nil="true" />	
	<CountyList>
		<County>
			<HighestActivityLevel i:nil="true" />
			<Id>20</Id>
			<MunicipalityList i:nil="true" />
			<Name>Finnmark</Name>
		</County>
	</CountyList>
	<MunicipalityCsvString>2020;</MunicipalityCsvString>
	<MunicipalityList>
		<Municipality>
			<Id>2020</Id>
			<Name>PORSANGER</Name>
			<WarningList i:nil="true" />
		</Municipality>
	</MunicipalityList>
	<ExposedClimateType>2</ExposedClimateType>
	<ExposedHeightType>1</ExposedHeightType>
	<ExposedHeightValue>300</ExposedHeightValue>	
	<MainText>Moderat fare for jordskred grunnet mye regn</MainText>
	<WarningText>
		Det ventes store nedbørsmengder søndag. Nedbørmengden er noe usikker. Høy grunnvannstand. 
		Bratte skråninger, samt bekker og elveløp med stor vannføring er spesielt utsatt. 
		Rensing av dreneringsveier og stikkrenner anbefales. 
		Se menyen over for ”Bruk av varselet – beredskap”.
	</WarningText>
	<MicroBlogPostList>
		<MicroBlogPost>
			<Id>2</Id>
			<WarningId>8982</WarningId>
			<EventId>8982</EventId>
			<Version>1</Version>
			<DateTime>2013-11-11T07:53:00</DateTime>
			<Text>Dette er andre innlegg</Text>
		</MicroBlogPost>
		<MicroBlogPost>
			<Id>1</Id>
			<WarningId>8982</WarningId>
			<EventId>8982</EventId>
			<Version>2</Version>
			<DateTime>2013-11-11T07:53:00</DateTime>
			<Text>Dette er første innlegg</Text>
		</MicroBlogPost>
	</MicroBlogPostList>
	<CauseList>
		<Cause>
			<Id>2</Id>
			<Name>Intens regn (bygenedbør)</Name>
		</Cause>
	</CauseList>
</Warning>
	

5.1 CountyOverview

Nesten lik struktur som CountySummary.
Forskjellen er at denne kun inneholder en liste av fylker (County), men kun kommuner som faktisk har et varsel med aktsomhetsnivå fra 2 eller høyere.

<ArrayOfCounty>
	<County>
		<Id>20</Id>
		<Name>Finnmark</Name>
		<HighestActivityLevel>4</HighestActivityLevel>
		<MunicipalityList>
			<Municipality>
				<Id>2030</Id>
				<Name>Sør-Varanger</Name>
				<WarningList>
					<Warning i:type="FloodWarning">...</Warning>
					...
				</WarningList>
			</Municipality>
			...
		</MunicipalityList>
	</County>
	...
</ArrayOfCounty>
	

5.2 CountySummary

En struktur som inneholder alle fylker og kommuner i Norge. Hver kommune inneholder en liste med varsel der antallet er basert på dato forespørselen
Hvert fylke (County) har et element (HighestActivityLevel) som indikerer høyeste aktsomhetsnivå i fylket.
EmergencyWarningSummary inneholder en liste med beredskapsmeldinger
MapCommentaryList inneholder kommentarer til prognosekart som ligger på varsom.
PublishTimeList inneholder tidspunkt for sist oppdatert og når neste varsling vil skje innen. Den inneholder en liste hvor antallet er basert på dato forespørselen

<CountySummary>
	<CountyList>
		<County>
			<Id>20</Id>
			<Name>Finnmark</Name>
			<HighestActivityLevel>4</HighestActivityLevel>
			<MunicipalityList>
				<Municipality>
					<Id>2030</Id>
					<Name>Sør-Varanger</Name>
					<WarningList>
						<Warning i:type="FloodWarning">...</Warning>
						...
					</WarningList>
				</Municipality>
				...
			</MunicipalityList>
		</County>
		...
	</CountyList>
	<EmergencyWarningSummary>
		<EmergencyWarningList>
			<EmergencyWarning>...</EmergencyWarning>
			...
		</EmergencyWarningList>
		<FrontPageEmergencyWarningList>
			<EmergencyWarning>...</EmergencyWarning>
			...
		</FrontPageEmergencyWarningList>
	</EmergencyWarningSummary>
	<MapCommentaryList>
		<MapComment>...</MapComment>
		...
	</MapCommentaryList>
	<PublishTimeList>
		<PublishTime>
			<NextWarningTime>2014-11-21T11:00:00</NextWarningTime>
			<PublishDateTime>2014-11-21T00:00:00</PublishDateTime>
			<ValidFrom>2014-11-21T00:00:00</ValidFrom>
		</PublishTime>
		...
	</PublishTimeList>
</CountySummary>
	

5.3 EmergencyWarningSummary

EmergencyWarningSummary inneholder en liste med beredskapsmeldinger til forsiden av varsom.no, og en liste med beredskapsmeldinger til undersiden Flom og jordskred.
Kun er ment for varsom.no

<EmergencyWarningSummary>
	<EmergencyWarningList>
		<EmergencyWarning>
			<PublishTime>2014-11-21T10:15:00</PublishTime>
			<UpdateTime>2014-11-21T10:15:00</UpdateTime>
			<ValidFrom>2014-11-21T00:00:00</ValidFrom>
			<ValidTo>2014-11-21T23:59:00</ValidTo>
			<Version>0</Version>
			<WarningLevel>4</WarningLevel>
			<MainText>Overskrift</MainText>
			<WarningText>Beredskapsmelding</WarningText>
		</EmergencyWarning>
	</EmergencyWarningList>
	<FrontPageEmergencyWarningList>
		<EmergencyWarning>
			<PublishTime>2014-11-21T10:15:00</PublishTime>
			<UpdateTime>2014-11-21T10:15:00</UpdateTime>
			<ValidFrom>2014-11-21T00:00:00</ValidFrom>
			<ValidTo>2014-11-21T23:59:00</ValidTo>
			<Version>0</Version>
			<WarningLevel>4</WarningLevel>
			<MainText>Overskrift til forsiden</MainText>
			<WarningText/>
		</EmergencyWarning>
	</FrontPageEmergencyWarningList>
</EmergencyWarningSummary>
	

5.4 MapComments

MapCommentaryList inneholder kommentarer til prognosekart som ligger på varsom.
Kun er ment for varsom.no

<CommentsListSummary>
	<MapComments>
		<MapComment>
			<ValidFrom">2014-11-21T00:00:00</ValidFrom>
			<ValidTo">2014-11-21T23:59:00</ValidTo>
			<Author">Anders Wartiainen</Author>
			<Comment">Kommentar til prognosekart</Comment>
		</MapComment>
	</MapComments>
</CommentsListSummary>
	

5.5 Region

En liste av fylker og kommuner.

<ArrayOfCounty>
	<County>
		<Id>20</Id>
		<Name>Finnmark</Name>
		<MunicipalityList>
			<Municipality>
				<Id>2030</Id>
				<Name>Sør-Varanger</Name>
			</Municipality>
			...
		</MunicipalityList>
	</County>
	...
</ArrayOfCounty>
	

5.6 Warning

En liste av FloodWarning

<ArrayOfWarning>
	<Warning i:type="FloodWarning">...</Warning>
	...
</ArrayOfWarning>
	

5.7 WarningByCounty

En liste av FloodWarning gruppert under fylke og kommune

<County>
	<Id>20</Id>
	<Name>Finnmark</Name>
	<MunicipalityList>
		<Municipality>
			<Id>2030</Id>
			<Name>Sør-Varanger</Name>
			<WarningList>
				<Warning i:type="FloodWarning">...</Warning>
				...
			</WarningList>
		</Municipality>
		...
	</MunicipalityList>
</County>
	

5.8 WarningByMunicipality

En liste av FloodWarning

<ArrayOfWarning>
	<Warning i:type="FloodWarning">...</Warning>
	...
</ArrayOfWarning>
	

6 Kontakt

Spørsmål kan stilles til Anders Wartiainen.