Frequently Asked Questions (FAQ)
- 1. Who is the OpenSky Network?
- 2. Where do we get our data from?
- 3. I want coverage in my area! What can I do?
- 4. What will happen with the data I stream to OpenSky?
- 5. How can I get access to OpenSky's data?
- 6. Is there a live API? Can I use it for my application?
- 7. I used OpenSky data for my research. Can I publish the results?
- 8. Can I share the data with my colleagues?
- 9. Can I use graphs and information from OpenSky for my publications, talks, or website?
- 10. The uptime of my receiver never exceeds 24h! Why?
- 11. My receiver is shown as offline even though it is definitely online! Why?
- 12. Where do the long spikes in the range of my reciever come from?
- 13. Which data can OpenSky provide?
- 14. When/how do you get origin/destination airports for flights? Why are there no flights for today?
- 15. An airport is missing, how can I add it?
- 16. An aircraft's details are incorrect or missing, how can I fix this?
- 17. I need more API requests/credits per day. How do I get them?
1. Who is the OpenSky Network?
The OpenSky Network was initiated in 2012 by researchers from armasuisse (Switzerland), University of Kaiserslautern (Germany), and University of Oxford (UK). The objective was (and still is!) to provide high quality air traffic data to researchers. By now, the OpenSky Network has become a non-profit association based in Switzerland and is supported by a growing number of contibutors from industry and academia. Researchers from different areas are using the data that is provided by people from all around the world.
2. Where do we get our data from?
The technology which is used by the OpenSky Network is the Automatic Dependent Surveillance-Broadcast (ADS-B). The ADS-B allows airplanes to determine their position and velocity using GPS. Airplanes then periodically broadcast this and other information on the 1090 MHz radio frequency. To obtain this valuable information at a large scale, we operate a network of ADS-B receivers around the globe and harvest the data via the Internet. Our receivers are sponsored or hosted by private people, industrial partners, and academic/governmental organizations. If you would like to support the project by becoming a contributor or receiver host, please refer to this article.
3. I want coverage in my area! What can I do?
The first thing you need is an ADS-B receiver. At the moment, we support the following devices: Radarcape and dump1090-based receivers (mutability and antirez forks) plus FLARM / OGN. In case you do not own such a device but you have access to a location with power supply, permanent Internet connection, a good line of sight in all directions and you are willing to host one of our devices for free, please refer to this article for more information. Once you obtain one of the listed devices, you need a free account for this website. You can simply create one by registering here. After logging in, you can add your receiver in the My OpenSky>Receiver Profile. After approval by one of our admins, your receivers automatically starts streaming the data to our servers. In case it remains offline, please check the receiver's setup, Internet connection, or contact us for further support.
4. What will happen with the data I stream to OpenSky?
5. How can I get access to OpenSky's data?
In principle, everyone can have access to the data, however, due to limited resources, or association's policy therefore is to grant free access only to research institutions, aviation authorities, governmental organizations, and other non-profit organizations. We further preserve the right to control this access and in particular, to refuse access if we think the application is for example not ethical. You can apply for access here by giving us a brief description of how you will use the data and what data you need. If you are from an eligible institution, please use an affiliated email address! Please note that in any case, you need an account for our platform to get access to the data. Access to the full dataset is currently only supported via an Impala shell and can be used to calculate statistics or perform direct searches with small result sets. Beyond this, we release many pre-curated datasets, see our dataset page.
6. Is there a live API? Can I use it for my application?
Yes there is! You can find it here: OpenSky API Documentation.Also read this as a starting point. We have language bindings for Python and Java. The API also supports retrieving historical data (within some limits though!). You can freely use the API for personal and non-profit applications but any commercial use requires our consent. Such commercial use includes, but is not limited to, selling applications using the API, advertisements on a web page/application using the API, and also internal use by any commercial for-profit entity that goes beyond testing and evaulating the quality of the data. If you have any problems, questions, bug reports, or ideas regarding the API, please use our forum and let us know.
7. I used OpenSky data for my research. Can I publish the results?
8. Can I share the data with my colleagues?
9. Can I use graphs and information from OpenSky for my publications, talks, or website?
Yes! Sharing is caring and the OpenSky Network's philosophy is to give back as much as possible to the world. If you use any information of the OpenSky network, we would highly appreciate being credited with providing the information.
10. The uptime of my receiver never exceeds 24h! Why?
This can have many reasons. One common cause is that most Internet providers reset connections once during the night. This results in a short disruption of the receiver's connection to our servers. However, this distruption should not last longer than a couple of minutes. In case you observe longer outages, please contact us and we will help you to identify and resolve the problem.
11. My receiver is shown as offline even though it is definitely online! Why??
If your receiver is up and running, this display can have several reasons. There could be connection issues for example. However, most likely there are simply no aircraft in range of the receiver at that point in time. If there are no aircraft messages send to OpenSky for an extended period of time, this receiver is then also shown as "offline".
12. Where do the long spikes in the range of my receiver come from?
Some airplanes transmit false or erroneous positions. Since we rely on the airplanes position reports for determining the range of a receiver, such erroneous position reports can result in wrong measurements for certain directions. The result is spikes in the ranges. Although we perform a lot filtering and reasonableness tests already, some of the bad position reports pass anyway.
13. Which data can OpenSky provide?
The OpenSky network collects raw air traffic control communication. It monitors the 1090 MHz SSR Mode S downlink channel, including ADS-B and has also recently started collecting FLARM data. This means that we can provide on the one hand low-level data (down to single transponder transmissions) and on the other hand high-level tracking data of the form "at date and time T, aircraft A was at position X and altitude Y and moved into direction D at a speed of V".
Furthermore, we derive origin and destination of a flight from this track data where possible. The process is described in this paper. While we have began to integrate some route information into the live view of the OpenSky Explorer, we do not currently map this to commercial flight schedules. This means that we cannot give any information on, for example, scheduled flights, cancellations, delays, flight numbers, or passenger counts! While more information may be inferred by combining our data with other data sources, this is beyond the scope of our services. For crowdsourced aircraft metadata, you can use our aircraft database.
Generally, we don't have any data at all from before 2013 and have the best coverage in Europe and the US. Regarding our day-to-day coverage, you can check it on our Coverage & Facts page.
14. When/how do you get origin/destination airports for flights? Why are there no flights for today?
We infer flights for both our Rest API and our Impala database in a nightly batch procedure from the ADS-B tracks collected for the finished day (UTC). For some more information on how they are derived, you can refer to this publication.This also means that we only have historical flight data for previous days, no live flights and no commercial data about schedules, delays or cancellations etc (definitely no passenger numbers!).
15. An airport is missing on your webpage! How do I add them?
We source our airports from the open source option ourairports.com. If your airport is not in the downloadable CSV or has an issue such as incorrect data, we might not be able to add them. We suggest you add it on their webpage and let us know about it in this forum thread.
16. An aircraft's details are incorrect or missing, how can I fix this?
We source our aircraft details such as transponder ID, registration, type or owner from various available sources. Besides such sources, we rely on your crowdsourced knowledge! As many countries do not make this information accessible, you can update missing or wrong information or add new aircraft in our aircraft database. Click "Edit airframe" on the respective aircraft page or go to this page to add a new airframe.
17. I need more API requests/credits per day. How do I get them?
The REST API access is always provided 'as is', and we reserve the right to change access or introduce rate limiting as required. As a small non-profit it is necessary to do this; at this point this is only the case for the /all endpoint. Other endpoints are unrestricted. If you are an institutional (i.e., typically academic) researcher, you can request unlimited access to the API. This also includes access to the historical database, which actually renders continuous API access unnecessary for all non-real-time/research applications and is the superior/preferred data access solution compared to repeated REST API requests.