FlightRadarAPI 1.3.25__tar.gz → 1.3.26__tar.gz

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

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

{flightradarapi-1.3.25 → flightradarapi-1.3.26}/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.26"
 
 from .api import FlightRadar24API, FlightTrackerConfig
 from .entities import Airport, Entity, Flight

{flightradarapi-1.3.25 → flightradarapi-1.3.26}/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.26}/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.25 → flightradarapi-1.3.26}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: FlightRadarAPI
-Version: 1.3.25
+Version: 1.3.26
 Summary: SDK for FlightRadar24
 Project-URL: Homepage, https://github.com/JeanExtreme002/FlightRadarAPI
 Author-email: Jean Loui Bernard Silva de Jesus <jeanextreme002@gmail.com>
@@ -32,7 +32,8 @@ See more information at: https://www.flightradar24.com/terms-and-conditions
 [![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/)
+[![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:
 ```
@@ -126,6 +127,20 @@ distance = flight.get_distance_from(airport)
 print(f"The flight is {distance} km away from the airport.")
 ```
 
+## Downloading Flight Data
+*Note*: This requires a premium subscription and for you to be logged in.
+
+```py
+history_data = fr_api.get_history_data(flight, file_type="csv", time=1706529600)
+
+ with open("history_data.csv", "w") as file:
+    file.write(history_data)
+```
+
+`flight_id` - The ID of the flight. Can be gotten from any other function that returns flight details.
+`file_type` - Either CSV or KML.
+`time` - The STD/scheduled time of deperature in UTC of the flight as a Unix timestamp. Putting an invalid time will return a blank document.
+
 ## 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.

{flightradarapi-1.3.25 → flightradarapi-1.3.26}/README.md

@@ -9,7 +9,8 @@ See more information at: https://www.flightradar24.com/terms-and-conditions
 [![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/)
+[![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:
 ```
@@ -103,6 +104,20 @@ distance = flight.get_distance_from(airport)
 print(f"The flight is {distance} km away from the airport.")
 ```
 
+## Downloading Flight Data
+*Note*: This requires a premium subscription and for you to be logged in.
+
+```py
+history_data = fr_api.get_history_data(flight, file_type="csv", time=1706529600)
+
+ with open("history_data.csv", "w") as file:
+    file.write(history_data)
+```
+
+`flight_id` - The ID of the flight. Can be gotten from any other function that returns flight details.
+`file_type` - Either CSV or KML.
+`time` - The STD/scheduled time of deperature in UTC of the flight as a Unix timestamp. Putting an invalid time will return a blank document.
+
 ## 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.

{flightradarapi-1.3.25 → flightradarapi-1.3.26}/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",