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 | ”2024-08-09T07:05:00Z” |
uniqueId | Alltid inkludert. Attributt for elementet flight | "1617049968" |
flightId | Alltid inkludert. Sub-element av ”flight” | "SK4167" |
dom_int | Alltid inkludert. Viser om det er en innenriks (D), | "D" |
schedule_time | Alltid inkludert. ankomst/avgangstid. | "2024-08-09T07:05:00Z" |
arr_dep | Alltid inkludert. Angir ankomst eller avgang. | "D" |
airport | Alltid inkludert. Viser IATA kode for ankomst- | "BGO" |
airline | Alltid inkludert. Viser IATA kode for flyselskap. | "VF" |
via_airport | Viser eventuelle mellomlandinger, max. | "SVG, BOO" |
check_in | Viser innsjekkingsområde dersom dette er | "1 2 3" |
gate | Viser gatenummer. | "B32" |
status code | Attributt «code» på elementet status angir | 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 | "2024-08-09T07:05:00Z" |
belt_number | Angir hvilket bagasjebånd som benyttes | "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 |
|