FlightRadarAPI 1.3.25__tar.gz → 1.3.27__tar.gz

{flightradarapi-1.3.25 → flightradarapi-1.3.27}/.gitignore

@@ -5,3 +5,5 @@ dist
 .idea/
 venv/
 node_modules/
+.env
+.cache

{flightradarapi-1.3.25 → flightradarapi-1.3.27}/FlightRadar24/__init__.py

@@ -13,7 +13,7 @@ https://www.flightradar24.com/terms-and-conditions
 """
 
 __author__ = "Jean Loui Bernard Silva de Jesus"
-__version__ = "1.3.25"
+__version__ = "1.3.27"
 
 from .api import FlightRadar24API, FlightTrackerConfig
 from .entities import Airport, Entity, Flight

{flightradarapi-1.3.25 → flightradarapi-1.3.27}/FlightRadar24/api.py

@@ -333,6 +333,30 @@ class FlightRadar24API(object):
         """
         return dataclasses.replace(self.__flight_tracker_config)
 
+    def get_history_data(self, flight: Flight, file_type: str, timestamp: int) -> Dict:
+        """
+        Download historical data of a flight.
+
+        :param flight: A Flight instance
+        :param file_type: Must be "CSV" or "KML"
+        :param timestamp: A Unix timestamp
+        """
+        if not self.is_logged_in():
+            raise LoginError("You must log in to your account.")
+
+        file_type = file_type.lower()
+
+        if file_type not in ["csv", "kml"]:
+            raise ValueError(f"File type '{file_type}' is not supported. Only CSV and KML are supported.")
+
+        response = APIRequest(
+            Core.historical_data_url.format(flight.id, file_type, timestamp),
+            headers=Core.json_headers, cookies=self.__login_data["cookies"],
+        )
+
+        content = response.get_content()
+        return str(content.decode("utf-8"))
+
     def get_login_data(self) -> Dict[Any, Any]:
         """
         Return the user data.

{flightradarapi-1.3.25 → flightradarapi-1.3.27}/FlightRadar24/core.py

@@ -23,6 +23,9 @@ class Core(ABC):
     real_time_flight_tracker_data_url = data_cloud_base_url + "/zones/fcgi/feed.js"
     flight_data_url = data_live_base_url + "/clickhandler/?flight={}"
 
+    # Historical data URL.
+    historical_data_url = flightradar_base_url + "/download/?flight={}&file={}&trailLimit=0&history={}"
+
     # Airports data URLs.
     api_airport_data_url = api_flightradar_base_url + "/airport.json"
     airport_data_url = flightradar_base_url + "/airports/traffic-stats/?airport={}"

flightradarapi-1.3.27/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.3
+Name: FlightRadarAPI
+Version: 1.3.27
+Summary: SDK for FlightRadar24
+Project-URL: Homepage, https://github.com/JeanExtreme002/FlightRadarAPI
+Author-email: Jean Loui Bernard Silva de Jesus <jeanextreme002@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: aircraft,airlines,airports,api,aviation,flightradar24,flights,radar
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.7
+Requires-Dist: brotli
+Requires-Dist: requests
+Provides-Extra: tests
+Requires-Dist: pytest; extra == 'tests'
+Description-Content-Type: text/markdown
+
+# FlightRadarAPI
+Unofficial SDK for [FlightRadar24](https://www.flightradar24.com/) for Python 3 and NodeJS.
+
+If you want to use the data collected using this SDK commercially, you need to subscribe to the [Business plan](https://www.flightradar24.com/premium/).</br>
+See more information at: https://www.flightradar24.com/terms-and-conditions
+
+[![Python Package](https://github.com/JeanExtreme002/FlightRadarAPI/workflows/Python%20Package/badge.svg)](https://github.com/JeanExtreme002/FlightRadarAPI/actions)
+[![Pypi](https://img.shields.io/pypi/v/FlightRadarAPI?logo=pypi)](https://pypi.org/project/FlightRadarAPI/)
+[![License](https://img.shields.io/pypi/l/FlightRadarAPI)](https://github.com/JeanExtreme002/FlightRadarAPI)
+[![Python Version](https://img.shields.io/badge/python-3.7+-8A2BE2)](https://pypi.org/project/FlightRadarAPI/)
+[![Npm](https://img.shields.io/npm/v/flightradarapi?logo=npm&color=red)](https://www.npmjs.com/package/flightradarapi)
+[![Downloads](https://static.pepy.tech/personalized-badge/flightradarapi?period=total&units=international_system&left_color=grey&right_color=orange&left_text=downloads)](https://pypi.org/project/FlightRadarAPI/)
+[![Frequency](https://img.shields.io/pypi/dm/flightradarapi?style=flat&label=frequency)](https://pypi.org/project/FlightRadarAPI/)
+## Installing FlightRadarAPI
+**For Python with pip:**
+```
+pip install FlightRadarAPI
+```
+**For NodeJS with npm:**
+```
+npm install flightradarapi
+```
+
+## Documentation
+Explore the documentation of FlightRadarAPI package, for Python or NodeJS, through [this site](https://JeanExtreme002.github.io/FlightRadarAPI/).

flightradarapi-1.3.27/README.md

@@ -0,0 +1,25 @@
+# FlightRadarAPI
+Unofficial SDK for [FlightRadar24](https://www.flightradar24.com/) for Python 3 and NodeJS.
+
+If you want to use the data collected using this SDK commercially, you need to subscribe to the [Business plan](https://www.flightradar24.com/premium/).</br>
+See more information at: https://www.flightradar24.com/terms-and-conditions
+
+[![Python Package](https://github.com/JeanExtreme002/FlightRadarAPI/workflows/Python%20Package/badge.svg)](https://github.com/JeanExtreme002/FlightRadarAPI/actions)
+[![Pypi](https://img.shields.io/pypi/v/FlightRadarAPI?logo=pypi)](https://pypi.org/project/FlightRadarAPI/)
+[![License](https://img.shields.io/pypi/l/FlightRadarAPI)](https://github.com/JeanExtreme002/FlightRadarAPI)
+[![Python Version](https://img.shields.io/badge/python-3.7+-8A2BE2)](https://pypi.org/project/FlightRadarAPI/)
+[![Npm](https://img.shields.io/npm/v/flightradarapi?logo=npm&color=red)](https://www.npmjs.com/package/flightradarapi)
+[![Downloads](https://static.pepy.tech/personalized-badge/flightradarapi?period=total&units=international_system&left_color=grey&right_color=orange&left_text=downloads)](https://pypi.org/project/FlightRadarAPI/)
+[![Frequency](https://img.shields.io/pypi/dm/flightradarapi?style=flat&label=frequency)](https://pypi.org/project/FlightRadarAPI/)
+## Installing FlightRadarAPI
+**For Python with pip:**
+```
+pip install FlightRadarAPI
+```
+**For NodeJS with npm:**
+```
+npm install flightradarapi
+```
+
+## Documentation
+Explore the documentation of FlightRadarAPI package, for Python or NodeJS, through [this site](https://JeanExtreme002.github.io/FlightRadarAPI/).

{flightradarapi-1.3.25 → flightradarapi-1.3.27}/pyproject.toml

@@ -17,7 +17,7 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11"
 ]
-exclude = ["tests"]
+exclude = ["tests", ".flake8"]
 requires-python = ">=3.7"
 dependencies = [
   "Brotli",

flightradarapi-1.3.25/PKG-INFO

@@ -1,142 +0,0 @@
-Metadata-Version: 2.1
-Name: FlightRadarAPI
-Version: 1.3.25
-Summary: SDK for FlightRadar24
-Project-URL: Homepage, https://github.com/JeanExtreme002/FlightRadarAPI
-Author-email: Jean Loui Bernard Silva de Jesus <jeanextreme002@gmail.com>
-License-Expression: MIT
-License-File: LICENSE
-Keywords: aircraft,airlines,airports,api,aviation,flightradar24,flights,radar
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Requires-Python: >=3.7
-Requires-Dist: brotli
-Requires-Dist: requests
-Provides-Extra: tests
-Requires-Dist: pytest; extra == 'tests'
-Description-Content-Type: text/markdown
-
-# FlightRadarAPI
-Unofficial SDK for [FlightRadar24](https://www.flightradar24.com/) written in Python 3.
-
-If you want to use the data collected using this SDK commercially, you need to subscribe to the [Business plan](https://www.flightradar24.com/premium/).</br>
-See more information at: https://www.flightradar24.com/terms-and-conditions
-
-[![Python Package](https://github.com/JeanExtreme002/FlightRadarAPI/workflows/Python%20Package/badge.svg)](https://github.com/JeanExtreme002/FlightRadarAPI/actions)
-[![Pypi](https://img.shields.io/pypi/v/FlightRadarAPI?logo=pypi)](https://pypi.org/project/FlightRadarAPI/)
-[![License](https://img.shields.io/pypi/l/FlightRadarAPI)](https://github.com/JeanExtreme002/FlightRadarAPI)
-[![Python Version](https://img.shields.io/badge/python-3.7+-8A2BE2)](https://pypi.org/project/FlightRadarAPI/)
-[![Npm](https://img.shields.io/npm/v/flightradarapi?logo=npm&color=red)](https://www.npmjs.com/package/flightradarapi)
-[![Downloads](https://static.pepy.tech/personalized-badge/flightradarapi?period=total&units=international_system&left_color=grey&right_color=orange&left_text=Downloads)](https://pypi.org/project/FlightRadarAPI/)
-
-## Installing FlightRadarAPI:
-```
-pip install FlightRadarAPI
-```
-
-## Basic Usage:
-Import the class `FlightRadar24API` and create an instance of it.
-```py
-from FlightRadar24 import FlightRadar24API
-fr_api = FlightRadar24API()
-```
-
-**Getting flights list:**
-```py
-flights = fr_api.get_flights(...)  # Returns a list of Flight objects
-```
-
-**Getting airports list:**
-```py
-airports = fr_api.get_airports(...)  # Returns a list of Airport objects
-```
-
-**Getting airlines list:**
-```py
-airlines = fr_api.get_airlines()
-```
-
-**Getting zones list:**
-```py
-zones = fr_api.get_zones()
-```
-
-### Getting flight and airport details
-You can also get more information about a specific flight such as: estimated time, trail, aircraft details, etc.
-```py
-flight_details = fr_api.get_flight_details(flight)
-flight.set_flight_details(flight_details)
-
-print("Flying to", flight.destination_airport_name)
-```
-
-Or get more information about a specific airport such as: runways, weather, arrived flights, etc.
-```py
-airport_details = fr_api.get_airport_details(icao)
-```
-Arrivals and departures can have a limit `flight_limit` (max value is 100) to display. When you need to reach more than 100 flights you can use additional parameter `page` to view other pages.
-
-
-## Get flights above your position:
-The `get_bounds_by_point(...)` method has parameters `latitude` and `longitude` for your position and `radius` for the distance in meters from your position to designate a tracking area.
-```py
-# Your point is 52°34'04.7"N 13°16'57.5"E from Google Maps and radius 2km
-bounds = fr_api.get_bounds_by_point(52.567967, 13.282644, 2000)
-
-flights = fr_api.get_flights(bounds = bounds)
-```
-
-## Filtering flights and airports:
-The `get_flights(...)` method has some parameters to search for flights by: area line, bounds (customized coordinates 
-or obtained by the `get_zones()` method), aircraft registration or aircraft type. See the example below:
-```py
-airline_icao = "UAE"
-aircraft_type = "B77W"
-
-# You may also set a custom region, such as: bounds = "73,-12,-156,38"
-zone = fr_api.get_zones()["northamerica"]
-bounds = fr_api.get_bounds(zone)
-
-emirates_flights = fr_api.get_flights(
-    aircraft_type = aircraft_type
-    airline = airline_icao,
-    bounds = bounds
-)
-```
-There are more configurations that you may set by using the `set_flight_tracker_config(...)` method. See the method documentation
-for more information.
-
-**Getting airport by ICAO or IATA:**
-```py
-lukla_airport = fr_api.get_airport(code = "VNLK", details = True)
-```
-
-## Getting the distance between flights and airports:
-The `Flight` and `Airport` classes inherit from `Entity`, which contains the `get_distance_from(...)` method. That method
-returns the distance between the self instance and another entity in kilometers. Example:
-```py
-airport = fr_api.get_airport("KJFK")
-distance = flight.get_distance_from(airport)
-
-print(f"The flight is {distance} km away from the airport.")
-```
-
-## Setting and getting Real-time Flight Tracker parameters:
-Set it by using the `set_flight_tracker_config(...)` method. It receives a `FlightTrackerConfig` dataclass instance, but
-you can also use keyword arguments directly to the method.
-
-Get the current configuration with the `get_flight_tracker_config()` method, that returns a `FlightTrackerConfig` 
-instance. Note: creating a new `FlightTrackerConfig` instance means resetting all parameters to default.
-```py
-flight_tracker = fr_api.get_flight_tracker_config()
-flight_tracker.limit = 10
-
-fr_api.set_flight_tracker_config(flight_tracker, ...)
-
-flights = fr_api.get_flights(...)  # Returns only 10 flights
-```

flightradarapi-1.3.25/README.md

@@ -1,119 +0,0 @@
-# FlightRadarAPI
-Unofficial SDK for [FlightRadar24](https://www.flightradar24.com/) written in Python 3.
-
-If you want to use the data collected using this SDK commercially, you need to subscribe to the [Business plan](https://www.flightradar24.com/premium/).</br>
-See more information at: https://www.flightradar24.com/terms-and-conditions
-
-[![Python Package](https://github.com/JeanExtreme002/FlightRadarAPI/workflows/Python%20Package/badge.svg)](https://github.com/JeanExtreme002/FlightRadarAPI/actions)
-[![Pypi](https://img.shields.io/pypi/v/FlightRadarAPI?logo=pypi)](https://pypi.org/project/FlightRadarAPI/)
-[![License](https://img.shields.io/pypi/l/FlightRadarAPI)](https://github.com/JeanExtreme002/FlightRadarAPI)
-[![Python Version](https://img.shields.io/badge/python-3.7+-8A2BE2)](https://pypi.org/project/FlightRadarAPI/)
-[![Npm](https://img.shields.io/npm/v/flightradarapi?logo=npm&color=red)](https://www.npmjs.com/package/flightradarapi)
-[![Downloads](https://static.pepy.tech/personalized-badge/flightradarapi?period=total&units=international_system&left_color=grey&right_color=orange&left_text=Downloads)](https://pypi.org/project/FlightRadarAPI/)
-
-## Installing FlightRadarAPI:
-```
-pip install FlightRadarAPI
-```
-
-## Basic Usage:
-Import the class `FlightRadar24API` and create an instance of it.
-```py
-from FlightRadar24 import FlightRadar24API
-fr_api = FlightRadar24API()
-```
-
-**Getting flights list:**
-```py
-flights = fr_api.get_flights(...)  # Returns a list of Flight objects
-```
-
-**Getting airports list:**
-```py
-airports = fr_api.get_airports(...)  # Returns a list of Airport objects
-```
-
-**Getting airlines list:**
-```py
-airlines = fr_api.get_airlines()
-```
-
-**Getting zones list:**
-```py
-zones = fr_api.get_zones()
-```
-
-### Getting flight and airport details
-You can also get more information about a specific flight such as: estimated time, trail, aircraft details, etc.
-```py
-flight_details = fr_api.get_flight_details(flight)
-flight.set_flight_details(flight_details)
-
-print("Flying to", flight.destination_airport_name)
-```
-
-Or get more information about a specific airport such as: runways, weather, arrived flights, etc.
-```py
-airport_details = fr_api.get_airport_details(icao)
-```
-Arrivals and departures can have a limit `flight_limit` (max value is 100) to display. When you need to reach more than 100 flights you can use additional parameter `page` to view other pages.
-
-
-## Get flights above your position:
-The `get_bounds_by_point(...)` method has parameters `latitude` and `longitude` for your position and `radius` for the distance in meters from your position to designate a tracking area.
-```py
-# Your point is 52°34'04.7"N 13°16'57.5"E from Google Maps and radius 2km
-bounds = fr_api.get_bounds_by_point(52.567967, 13.282644, 2000)
-
-flights = fr_api.get_flights(bounds = bounds)
-```
-
-## Filtering flights and airports:
-The `get_flights(...)` method has some parameters to search for flights by: area line, bounds (customized coordinates 
-or obtained by the `get_zones()` method), aircraft registration or aircraft type. See the example below:
-```py
-airline_icao = "UAE"
-aircraft_type = "B77W"
-
-# You may also set a custom region, such as: bounds = "73,-12,-156,38"
-zone = fr_api.get_zones()["northamerica"]
-bounds = fr_api.get_bounds(zone)
-
-emirates_flights = fr_api.get_flights(
-    aircraft_type = aircraft_type
-    airline = airline_icao,
-    bounds = bounds
-)
-```
-There are more configurations that you may set by using the `set_flight_tracker_config(...)` method. See the method documentation
-for more information.
-
-**Getting airport by ICAO or IATA:**
-```py
-lukla_airport = fr_api.get_airport(code = "VNLK", details = True)
-```
-
-## Getting the distance between flights and airports:
-The `Flight` and `Airport` classes inherit from `Entity`, which contains the `get_distance_from(...)` method. That method
-returns the distance between the self instance and another entity in kilometers. Example:
-```py
-airport = fr_api.get_airport("KJFK")
-distance = flight.get_distance_from(airport)
-
-print(f"The flight is {distance} km away from the airport.")
-```
-
-## Setting and getting Real-time Flight Tracker parameters:
-Set it by using the `set_flight_tracker_config(...)` method. It receives a `FlightTrackerConfig` dataclass instance, but
-you can also use keyword arguments directly to the method.
-
-Get the current configuration with the `get_flight_tracker_config()` method, that returns a `FlightTrackerConfig` 
-instance. Note: creating a new `FlightTrackerConfig` instance means resetting all parameters to default.
-```py
-flight_tracker = fr_api.get_flight_tracker_config()
-flight_tracker.limit = 10
-
-fr_api.set_flight_tracker_config(flight_tracker, ...)
-
-flights = fr_api.get_flights(...)  # Returns only 10 flights
-```