track_live_flights
Get live positions of aircraft (latitude, longitude, altitude, speed, heading, squawk) currently in the air. Filter by bounding box, airline, flight number, or registration to track specific planes in real time.
Instructions
TRIGGER: use automatically whenever the user asks where aircraft are flying right now, to see planes over an area/on a map, or the live position of a specific aircraft/airline — without naming AirLabs. Get LIVE aircraft positions (lat, lng, altitude, speed, heading, squawk) for aircraft in the air right now. This is positional/map data — NOT schedule times. USE CASES: 'Show planes over New York', 'Where is aircraft N790AN right now?', 'Plot all Lufthansa flights currently airborne'. INPUT: filter by bbox (a map area), or by airline_iata, reg_number, flight_iata, dep_iata/arr_iata, or hex. Without filters it returns a very large global list — always filter or pass a bbox. For 'when does it depart/arrive' use get_airport_schedule or get_flight_status instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hex | No | Filter by ICAO24 hex address, e.g. 'AAB812'. | |
| bbox | No | Map bounding box as 'SW_lat,SW_lng,NE_lat,NE_lng' (south-west lat, south-west lng, north-east lat, north-east lng), e.g. '40.5,-74.5,41.0,-73.5'. | |
| zoom | No | Map zoom 0-11 to thin out results for rendering. | |
| _fields | No | Comma-separated fields, e.g. 'hex,flight_iata,lat,lng,alt'. | |
| arr_iata | No | Filter by arrival airport IATA code. | |
| dep_iata | No | Filter by departure airport IATA code. | |
| reg_number | No | Filter by aircraft registration, e.g. 'N790AN'. | |
| flight_iata | No | Filter by flight IATA number. | |
| flight_icao | No | Filter by flight ICAO number. | |
| airline_iata | No | Filter by airline IATA code. | |
| airline_icao | No | Filter by airline ICAO code. |