_OgFSSKJrJrJrJrJrJr SSKrSSKrSSK J r SSK J r SSK Jr SSKJrJr SSKJr \R("S S \55r"S S \5rg) )AnyDictListOptionalTupleUnionN)Core)Airport)Flight)AirportNotFoundError LoginError) APIRequestc\rSrSr%SrSr\\S'Sr\\S'Sr \\S'Sr \\S'Sr \\S'Sr \\S 'Sr \\S 'Sr\\S 'Sr\\S 'S r\\S'Sr\\S'Sr\\S'Sr\\S'Srg)FlightTrackerConfigz; Data class with settings of the Real Time Flight Tracker. 1faa satellitemlatflarmadsbgndairvehicles estimated14400maxageglidersstats5000limitN)__name__ __module__ __qualname____firstlineno____doc__rstr__annotations__rrrrrrrrrrr r"__static_attributes__r#V/Users/admin/workspace/ai/Jarvis/env/lib/python3.13/site-packages/FlightRadar24/api.pyrrsCNIsD#OE3D#OCNCNHcIsFCGSE3E3r,rc\rSrSrSrS9S\\S\\S\4SjjrS\ \ 4S jr S \S \S\\ \ \44S jrS S.S\S\S\4SjjrS:S\S\S\S\ 4SjjrS\ 4SjrS\ \4SjrS\ 4SjrS\ \\4S\4SjrS\S\S\S\4SjrS\S\\ \ \44SjrS \S\ \\44S!jrS;S S.S"\\S#\\S$\\S%\\S\S\ \4 S&jjjrS\4S'jrS \S(\S)\S\ 4S*jr S\ \\44S+jr!S\ 4S,jr"S\ 4S-jr#S\ \\ 44S.jr$SFlightRadar24API#z" Main class of the FlightRadarAPI Nuserpasswordtimeoutcn[5UlSUlX0lUbUbUR X5 ggg)zz Constructor of the FlightRadar24API class. :param user: Your email (optional) :param password: Your password (optional) N)r(_FlightRadar24API__flight_tracker_config_FlightRadar24API__login_datar3login)selfr1r2r3s r-__init__FlightRadar24API.__init__(s;(;'<$,0#   4 JJt &!5 r,returnc[[R[RURS9nUR 5S$)z" Return a list with all airlines. headersr3rows)rr airlines_data_url json_headersr3 get_contentr8responses r- get_airlinesFlightRadar24API.get_airlines7s9d44d>O>OY]YeYef##%f--r,iataicaocUR5UR5p![RRX5n[ U[R S/UR S9nUR5n[U5RS5(d$UR5URS5S4$[RRU5n[ U[R UR S9nUR5n[U5RS5(d$UR5URS5S4$g)zL Download the logo of an airline from FlightRadar24 and return it as bytes. i)r>exclude_status_codesr34.r=N) upperr airline_logo_urlformatr image_headersr3get_status_coder) startswithrBsplitalternative_airline_logo_url)r8rGrHfirst_logo_urlrD status_codesecond_logo_urls r-get_airline_logo!FlightRadar24API.get_airline_logo>sZZ\4::+?+?+DR+HH H;;BB4Hot7I7ISWS_S_`..0 ;**3//'')?+@+@+Eb+II I0r,F)detailscoder[cS[U5:d[U5S:a[SUS35eU(a.[5nURU5nUR U5 U$[ [ RRU5[ RURS9nUR5nU(a+[U[5(aURS5(d[SUS35e[USS 9$) z Return basic information about a specific airport. :param code: ICAO or IATA of the airport :param details: If True, it returns an Airport instance with detailed information.  The code '9' is invalid. It must be the IATA or ICAO of the airport.r=r['Could not find an airport by the code ''.)info)len ValueErrorr get_airport_detailsset_airport_detailsrr airport_data_urlrPrAr3rB isinstancedictgetr )r8r\r[airportairport_detailsrDcontents r- get_airportFlightRadar24API.get_airportVs s4y=CIMz$/hij j iG"66tFzz'"" !>??&)PQUPVVX'Y[ab b":.zz)TV,00tvF D S)R)@%AQ%F3t9XY>&)PQUPVVX'YZ Z r,c[[R[RURS9nUR 5$)z Return airport disruptions. r=)rr airport_disruptions_urlrAr3rBrCs r-get_airport_disruptions(FlightRadar24API.get_airport_disruptionss4d::DDUDU_c_k_kl##%%r,c[[R[RURS9n[ 5nUR 5SHn[US9nURU5 M U$)z" Return a list with all airports. r=r?) basic_info) rr airports_data_urlrAr3listrBr append)r8rDairports airport_datarms r- get_airportsFlightRadar24API.get_airportssad44d>O>OY]YeYef"&&$0026:L6G OOG $;r,c.UR5(d [S5e[RR 5nUR 5SUS'UR Sn[[RXURS9nUR5$)z3 Get the bookmarks from the FlightRadar24 account. You must log in to your account. accessToken accesstokenrvr>rvr3) is_logged_inrr rAcopyget_login_datar6r bookmarks_urlr3rB)r8r>rvrDs r- get_bookmarksFlightRadar24API.get_bookmarkss  ""?@ @##((*!%!4!4!6}!E ##I.d00'\`\h\hi##%%r,zonecBSRUSUSUSUS5$)z Convert coordinate dictionary to a string "y1, y2, x1, x2". :param zone: Dictionary containing the following keys: tl_y, tl_x, br_y, br_x z {},{},{},{}tl_ybr_ytl_xbr_x)rP)r8rs r- get_boundsFlightRadar24API.get_boundss, ##DL$v,V dSYl[[r,latitude longituderadiusc [U5S- n[R"U5n[R"U5nSn[R"S[R"US5-5n[R "[R "U5[R"X- 5-[R"U5[R "X- 5-[R"S[RS- -5--5n U[R"[R "S[RS- -5[R "X- 5-[R"U5-[R"X- 5[R "U5[R "U 5-- 5-n [R "[R "U5[R"X- 5-[R"U5[R "X- 5-[R"S[RS- -5--5n U[R"[R "S[RS- -5[R "X- 5-[R"U5-[R"X- 5[R "U5[R "U 5-- 5-n [Rn U "U 5U "U 5U "U 5U "U 5S.nURU5$)z Convert a point coordinate and a radius to a string "y1, y2, x1, x2". :param latitude: Latitude of the point :param longitude: Longitude of the point :param radius: Radius in meters to create area around the point ii-)rrrr) absmathradianssqrtpowasinsincospiatan2degreesr)r8rrrhalf_side_in_kmlatlonapprox_earth_radiushypotenuse_distancelat_minlon_minlat_maxlon_maxrad2degrs r-get_bounds_by_point$FlightRadar24API.get_bounds_by_pointsf+,ll8$ll9%""iiTXXoq-I(JK)) HHSMDHH%8%NO Ohhsmhh*@ABhhsdggm,-. .   HHSDGGcM* +hh*@A Bhhsm  HH(> ?hhsmdhhw// 0   )) HHSMDHH%8%NO Ohhsmhh*@ABhhrTWWs]+,- -   HHR477S=) *hh*@A Bhhsm  HH(> ?hhsmdhhw// 0   ,,G$G$G$G$   t$$r,countryc[RRUR5R SS55n[R R 5nSU;aURS5 [X#URS9nUR5n[U5RS5(d$UR5URS5S4$g) zi Download the flag of a country from FlightRadar24 and return it as bytes. :param country: Country name  -originr=rKrLrMN)r country_flag_urlrPlowerreplacerQrpoprr3rRr)rSrBrT)r8rflag_urlr>rDrWs r-get_country_flag!FlightRadar24API.get_country_flags ((// 0G0GS0QR$$))+ w  KK !hN..0 ;**3//'')8>>#+>r+BB B0r,flightc[[RRUR5[R UR S9nUR5$)z[ Return the flight details from Data Live FlightRadar24. :param flight: A Flight instance r=)rr flight_data_urlrPidrAr3rB)r8rrDs r-get_flight_details#FlightRadar24API.get_flight_detailssC d2299&))DdN_N_imiuiuv##%%r,airlinebounds registration aircraft_typec[R"UR5nURbURSSUS'U(aXS'U(aUR SS5US'U(aX6S'U(aXFS '[ [ RU[ RURS 9nUR5n[5nUR5HfupU S R5(dM[X5n URU 5 U(dMDUR!U 5n U R#U 5 Mh U$) av Return a list of flights. See more options at set_flight_tracker_config() method. :param airline: The airline ICAO. Ex: "DAL" :param bounds: Coordinates (y1, y2 ,x1, x2). Ex: "75.78,-75.78,-427.56,427.56" :param registration: Aircraft registration :param aircraft_type: Aircraft model code. Ex: "B737" :param details: If True, it returns flights with detailed information rvrwencr,z%2Crregtype)r3r) dataclassesasdictr5r6rrr !real_time_flight_tracker_data_urlrAr3rBritems isnumericr rrset_flight_details) r8rrrrr[rrDflights flight_id flight_inforflight_detailss r- get_flightsFlightRadar24API.get_flightss $%++D,H,HI    ($($5$5i$@$IN5 ! 9- fnnS%.H>(+ . =0dDDnVZVgVgquq}q}~'') $&.nn&6 "IQ<))++I3F NN6 "w!%!8!8!@)).9'7r,cB[R"UR5$)zd Return a copy of the current config of the Real Time Flight Tracker, used by get_flights() method. )rrr5r8s r-get_flight_tracker_config*FlightRadar24API.get_flight_tracker_configLs""4#?#?@@r, file_type timestampcUR5(d [S5eUR5nUS;a[SUS35e[ [ R RURX#5[ RURSURS9nUR5n[URS55$)z Download historical data of a flight. :param flight: A Flight instance :param file_type: Must be "CSV" or "KML" :param timestamp: A Unix timestamp r)csvkmlz File type 'z3' is not supported. Only CSV and KML are supported.rvrzutf-8)rrrrfrr historical_data_urlrPrrAr6r3rBr)decode)r8rrrrDros r-get_history_data!FlightRadar24API.get_history_dataRs  ""?@ @OO% N *{9+5hij j  $ $ + +FIIy L%%t/@/@/KLL  &&(7>>'*++r,c|UR5(d [S5eURSR5$)z Return the user data. ruserData)rrr6rrs r-rFlightRadar24API.get_login_dataks9  ""?@ @  ,1133r,c[[R[RURS9nUR 5$)z Return the most tracked data. r=)rr most_tracked_urlrAr3rBrCs r-get_most_tracked!FlightRadar24API.get_most_trackedts4d33T=N=NX\XdXde##%%r,c[[R[RURS9nUR 5$)zL Return boundaries of volcanic eruptions and ash clouds impacting aviation. r=)rr volcanic_eruption_data_urlrAr3rBrCs r-get_volcanic_eruptions'FlightRadar24API.get_volcanic_eruptions{s4d==tGXGXbfbnbno##%%r,c[[R[RURS9nUR 5nSU;aUR S5 U$)z& Return all major zones on the globe. r=version)rr zones_data_urlrAr3rBr)r8rDzoness r- get_zonesFlightRadar24API.get_zonessLd114;L;LVZVbVbc$$&   IIi  r,queryr"c[[RRX5[RUR S9nUR 5RS/5nUR 5RS05nSnSn0nURS05R5HWup/X'XgU -:aBU[U5:a3XRXF5 US- nXgU -:aU[U5:aM3Xz- nMY U$)z Return the search result. r=resultsr rcountr ) rr search_data_urlrPrAr3rBrlrrer) r8rr"rDr r i counted_totalrnamer s r-searchFlightRadar24API.searchsd2299%GQUQbQblplxlxy&&(,,Y;$$&**7B7   99Wb1779KDDJe++CL0@ !!'*-Qe++CL0@  "M :  r,cURSL$)z= Check if the user is logged into the FlightRadar24 account. N)r6rs r-rFlightRadar24API.is_logged_ins  ,,r,cUUSSS.n[[R[RX0RS9nUR 5nUR 5n[U5RS5(aURS5(d.[U[5(a[US5e[S5eUS UR5S .Ulg ) z^ Log in to a FlightRadar24 account. :param user: Your email. :param password: Your password. trueweb)emailr2rememberr)r>rr32successmessagez#Your email or password is incorrectr)rrvN)rr user_login_urlrAr3rRrBr)rSrlrjrkr get_cookiesr6)r8r1r2rrDrWros r-r7FlightRadar24API.logins   d114;L;LSWamamn..0 &&(;**3//w{{97M7M'4(( 79;M0N*N"#HII +++- r,cURcgURSnSUl[[R[RXR S9n[ UR55RS5$)zs Log out of the FlightRadar24 account. Return a boolean indicating that it successfully logged out of the server. NTrvrr) r6rr rrAr3r)rRrS)r8rvrDs r-logoutFlightRadar24API.logoutsj    $T##I. d114;L;LV]gsgst8++-.99#>>r,flight_tracker_configconfigc :UbXl[R"UR5nUR5H^upE[ U5nXC;a[ SUS35eUR 5(d[SUS35e[URXE5 M` g)zL Set config for the Real Time Flight Tracker, used by get_flights() method. NzUnknown option: ''zValue must be a decimal. Got ') r5rrrr)KeyError isdecimal TypeErrorsetattr)r8r!r"current_config_dictkeyvalues r-set_flight_tracker_config*FlightRadar24API.set_flight_tracker_configs ! ,+@ ()001M1MN ,,.JCJE-!23%q9::??$$"@Q GHH D00# =)r,)__flight_tracker_config __login_datar3)NN )dr )NNNN)2)N),r$r%r&r'r(rr)intr9rrrErbytesrYboolr rprgrrrfloatrrrr rrrrrrrrrrrrr7rrr,r+r#r,r-r/r/#s 'Xc] 'Xc] '\_ '.d4j.JSJJuczAR8SJ09>000'04**3*C*X\*X&& d7m  &t &\tCJ/\C\4%E4%e4%U4%WZ4%lCCucz9J0KC$&&DcN&"& $&*'+ 11#1 1sm 1  } 11 f1fA+>A ,v,#,#,RV,24S#X4&$&&& 4T ? CT&-d-  #   6 ? ? @D>'(;<>S/>  >>r,r/)typingrrrrrrrrcorer entities.airportr entities.flightr ryr rrequestr dataclassobjectrr/r#r,r-r>sQ;: %#4 &&C>vC>r,