Flydata

Noe av innholdet på Avinors nettsider kan du benytte i dine egne tjenester uten å måtte betale for det.

Kontrollrom med store digitale skjermer og mennesker som står i ulike grupper, moderne teknologi i bruk.

Flydata i XML-format

Endringer i URL og parametere for XML-feedene:

URL-ene og parameterne for de nye XML-feeden er nå case-sensitiv. Hvis URL-en er feil med hensyn til små og store bokstaver, vil forespørselen mislykkes.
- Hvis parameterne er feil med hensyn til små og store bokstaver, vil parameteren ikke bli evaluert, og standardverdien vil bli brukt.
Estimerte tider vil bli oppdatert tidligere og hyppigere

Teknisk beskrivelse:

Datagrunnlaget i tjenestene er det samme som benyttes i våre egne internettløsninger, på informasjonsskjermer på flyplassene og hos samarbeidspartnere som f.eks Flytoget og NRK. Tjenestene inneholder ikke data fra private flyplasser som Sandefjord flyplass, Torp.

I punktene under finner du tekniske beskrivelser av datatjenestene vi tilbyr. Merk at beskrivelsene er beregnet for personer med kjennskap til XML-formatet.

xmlfeed	Beskrivelse
asrv.avinor.no/XmlFeed/v1.0	Flighter til og fra norske flyplasser
asrv.avinor.no/flightStatuses/v1.0	Status på flighter
asrv.avinor.no/airportNames/v1.0	Navn og IATA kode på flyplasser
asrv.avinor.no/airlineNames/v1.0	Navn og IATA kode på flyselskap

NB: Vennligst vær oppmerksom på korrekt bruk av store og små bokstaver i linkene og parameterne. Ved feil bruk vil linken ikke fungere og parameterne vil ikke bli tatt hensyn til.

Flight informasjon (inkl. oppdatert trafikkstatus) - asrv.avinor.no/XmlFeed/v1.0

Tjenesten gir deg tilgang til rutetabell for Avinors 43 lufthavner, samt kontinuerlig oppdatert trafikkstatus.

For å sikre at du tilbyr dine sluttbrukere korrekte/oppdaterte flydata, bør du hente flytider hvert 3. minutt. Hyppigere spørringer enn dette er ikke nødvendig. Vi henstiller til alle som benytter data fra Avinor om å mellomlagre (cache) dataene i egen tjeneste, og ikke la klienten (sluttbruker) gå direkte mot vår tjeneste.

Parametere

Parameter	Beskrivelse	Eksempel
airport	Obligatorisk. IATA-kode som styrer hvilken flyplass XML-uttrekket gjelder for.	airport=OSL
TimeFrom	Valgfri, standardverdi er én time. Styrer hvor langt tid tilbake det hentes flights for, rundet ned til hele timer.	TimeFrom=2
TimeTo	Valgfri, standardverdi er syv timer. Styrer hvor langt frem i tid det hentes flights for, rundet ned til hele timer.	TimeTo=5
direction	Valgfri, angir "retning" for en flight: A = "Arrivals", D = "Departures". Dersom ingen verdi velges så vises både A og D.	direction=D
lastUpdate	Valgfri, henter kun flydata som har blitt oppdatert etter et gitt tidspunkt.	lastUpdate=2024-08-08T09:30:00Z
codeshare	Valgfri, når dette parameteret blir inkludert så vil evt codeshare info bli lagt til flighten. Codeshare info består av codeshareAirlineDesignators, codeshareAirlineNames, codeshareFlightNumbers og codeshareOperationalSuffixs.	codeshare=Y
serviceType	Valgfri, Gir mulighet for å inkludere helikopter flighter ved å legge til parameteret serviceType «E». Helikopter flighter vil bli inkludert i resultatet, i tillegg til vanlige skedulerte flighter med servicetype ‘J’ (Schedule passenger) og ‘C’ (Charter passenger).	serviceType=E

Eksempel på forespørsel:

asrv.avinor.no/XmlFeed/v1.0?TimeFrom=1&TimeTo=7&airport=OSL&direction=D&lastUpdate=2024-08-08T09:30:00Z

Spørringen henter ut endringer i avganger på Oslo Lufthavn, én time tilbake og syv timer fram og kun for flighter oppdatert etter spesifisert dato/tid i lastUpdate.

Beskrivelse av attributter:

Øverste element (parent element) i XML-dokumentet har navnet airport. Dette elementet har et sub-element (child element) med navn flights og det inneholder igjen elementer av typen flight.

Attribute	Beskrivelse	Eksempel
lastUpdate	Alltid inkludert. Attributt for elementet flights som angir siste endringstidspunkt for flydata for den aktuelle flyplassen.	”2024-08-09T07:05:00Z”
uniqueId	Alltid inkludert. Attributt for elementet flight som angir unik ID for flight, max 12 tall	"1617049968"
flightId	Alltid inkludert. Sub-element av ”flight” som angir ID for flight.	"SK4167"
dom_int	Alltid inkludert. Viser om det er en innenriks (D), internasjonal (I) eller Schengen (S) flight.	"D"
schedule_time	Alltid inkludert. ankomst/avgangstid.	"2024-08-09T07:05:00Z"
arr_dep	Alltid inkludert. Angir ankomst eller avgang. A = "Ankomst", D = "Avgang".	"D"
airport	Alltid inkludert. Viser IATA kode for ankomst- eller avgangsflyplass avhengig av arr_dep. Se egen tjeneste for navn på flyplass nedenfor.	"BGO"
airline	Alltid inkludert. Viser IATA kode for flyselskap. Se egen tjeneste for navn på flyselskap nedenfor.	"VF"
via_airport	Viser eventuelle mellomlandinger, max. 10 IATA koder atskilt med komma «,».	"SVG, BOO"
check_in	Viser innsjekkingsområde dersom dette er oppgitt.	"1 2 3"
gate	Viser gatenummer. Kan inneholde både tall og bokstaver.	"B32"
status code	Attributt «code» på elementet status angir statustekst for en flight. Merk at statustekstene kan endres uten varsel. Se også egen tjeneste for statusteksterbeskrevet nedenfor.	A = "Landet" (Arrived) C = "Innstilt" (Cancelled) D = "Avreist" (Departed) E = "Ny tid" (New time) N = "Ny info" (New info).
status time	Attributt ”time” på elementet status angir statustidspunkt for en flight.	"2024-08-09T07:05:00Z"
belt_number	Angir hvilket bagasjebånd som benyttes for en flight.	"9"

Tidsangivelser

Alle tidsangivelser er oppgitt i UTC (Wikipedia:UTC, CET) og er på ISO 8601 (Wikipedia: ISO 8601-format) [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss]Z. Husk derfor å korrigere for vår tidssone, samt eventuell sommertid.

Eks: 2009-12-31T16:00:00 tilsvarer 31. desember 2009 kl 17:00 lokal tid i Norge (CET), mens 2009-06-23T16:00:00 tilsvarer 23. juni 2009 kl 18:00 lokal tid i Norge (Sommertid).

Flight Statuser - asrv.avinor.no/flightStatuses/v1.0

Tjenesten gir deg statustekst for statuskodene som er knyttet mot en flight.

Spørringer mot tjenesten hyppigere enn hver 24. time bør ikke være nødvendig for å sikre oppdaterte data.

Parametere

Parameter	Beskrivelse	Eksempel
code	Vise kun en av status kodene	code=N

Eksempel på forespørsel:

asrv.avinor.no/flightStatuses/v1.0?code=D

Flyplassnavn - asrv.avinor.no/airportNames/v1.0

Tjenesten gir deg tilgang til navn og IATA kode på norske og internasjonale flyplasser.

Spørringer mot tjenesten hyppigere enn hver 24. time bør ikke være nødvendig for å sikre oppdaterte data.

Parametere

Parameter	Beskrivelse	Eksempel
airport	Valgfri - Vise kun en av flyplassene	airport=OSL
shortname	Valgfri - Inkluder et kort navn for flyplassen i resultatet	shortname=Y

Eksempel på forespørsel:

asrv.avinor.no/airportNames/v1.0?airport=BGO&shortname=Y

Flyselskap - asrv.avinor.no/airlineNames/v1.0

Tjenesten gir deg tilgang til navn og IATA kode på norske og internasjonale flyselskaper.

Spørringer mot tjenesten hyppigere enn hver 24. time bør ikke være nødvendig for å sikre oppdaterte data.

Parametere

Parameter	Forklaring	Eksempel
	Det er ikke noen parametere tilgjengelig for å filtrere denne xmlfeeden

Bruksvilkår

Vi legger ingen begrensninger på hvordan data benyttes, så lenge innholdet ikke benyttes i sammenhenger som bryter norsk lov. Vi forbeholder oss retten til å stenge tilgangen for aktører som benytter tjenestene i sammenhenger som vurderes som skadelig for Avinors omdømme. Informasjon, men ikke begrunnelse, om slike beslutninger vil bli gitt dersom kontaktinformasjon er tilgjengelig.

Alt innhold fra våre tjenester skal merkes "Flydata fra Avinor". Teksten skal være en lenke til www.avinor.no, plasseres i umiddelbar nærhet til dataene og være godt synlig for sluttbruker.

Dersom du planlegger å benytte datatjenestene i sammenhenger som innebærer stor belastning på våre servere, ber vi deg kontakte oss i forkant. Avinor har dessverre ikke anledning til å yte teknisk support.

Avinor kan ikke garantere at innholdet er fullstendig, oppdatert eller tilgjengelig til enhver tid og sted. (Vi kan imidlertid love at vi gjør vårt beste med rådende ressurser og rammebetingelser.)

Har du spørsmål eller ønsker å komme i kontakt med oss, send en e-post til