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 receiver 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?
- 18. Why can't find an aircraft on the map that should be there?
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 2015, the OpenSky Network transitioned into a non-profit association based in Switzerland. OpenSky has taken part in two Horizon grants and is supported by a number of volunteers from industry government 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?
Due to limited resources, our association's policy therefore is to grant free access to the full data set only to research institutions, aviation authorities, governmental organizations, and other non-profit organizations. This does typically not include personal learning and research purposes by private individuals, instead we have made many datasets available for such use cases (see below).
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. We monitor the 1090 MHz SSR Mode S downlink channel, including ADS-B and also collect FLARM data and VHF/Voice. 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. More details on the credit system are available in the API documentation: In short, you should be logged in and be a feeder to get the maximum amount of API requests. As a small non-profit it is necessary to do such limiting; 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. If you have a non-profit cause with great impact, please contact us!
18. Why can't find an aircraft on the map that should be there?
If you think an aircraft should be there but isn't, there are two main reasons. a) It might be outside our coverage (too low, no sensor close by). b) It might not support ADS-B or FLARM but only Mode S, which does not provide a position but only the altitude. In this case, it should show up in the search box of the Explorer but naturally can't be displayed on the map. As we currently do not offer multilateration (MLAT), this affects also some military planes. Please note that those military planes that *really* do not want to be tracked will switch their entire transponders off. Either way, they are not being filtered.