AirPlx Radio

The full text behind one search result: the transmission and the rest of its radio conversation, in order, plus an AirPlx link. Times are the location's local time in 24-hour format (14:20).

fetch

One location's radio day, or part of it, in order and grouped into conversations: who said what, when (HH:MM:SS local), on which channel, about which tail. Use it for handovers, replays, "what happened this morning" and for measuring how long things took (the gap between a request and its "done"). A long silence ends a conversation, so a request and its completion are often separate conversations for the same tail. Each conversation carries one `transcript_id` (its first transmission): pass it to get_transcript for the full detail of every line, or put it in `url_template` to link the conversation. `end` is omitted for a single moment and `tails` when no aircraft was identified. A busy location has thousands of transmissions a day and one result holds 500 lines. `lines_by_hour` shows how many fall in each hour of the window, so pick the hours that matter; when `truncated` is true, call again with `start_time` set to `next_start_time` to continue. For an overview of a whole busy day prefer get_shift_summary. A line repeats its channel or tail only when its conversation has more than one. Times are local, in 24-hour format.

get_day_timeline

One radio transmission: raw and cleaned-up text, channel, tail, duration, recognition flags, and the other transmissions in the same conversation. `url` links to it; `url_template` links any line of the conversation. Times are the location's local time in 24-hour format (14:20).

get_transcript

The recording of one transmission, for the conversation player to play. Called by the player when the user presses play; the audio goes to the player only.

get_transmission_audio

The AirPlx operations notes for one location's radio day (local midnight to midnight): headline, overview, by service, by aircraft, follow-ups. If the day has not been summarized yet it is generated now, which can take a few minutes. Always write times in 24-hour format (14:20), never AM/PM.

get_shift_summary

Find radio transmissions across all of the user's locations from the last 30 days that match a free-text query. Returns ids, titles and AirPlx links; call fetch with an id for the full conversation. For filters (location, time window, channel, tail) use search_radio instead. Times in titles are local, in 24-hour format.

search

Search a location's radio transcripts, newest first. Filters combine. `total` is how many transmissions match, even when only `returned` of them are listed, so use it to answer "how many" questions. For a day or shift in order use get_day_timeline instead. To link a transmission, fill `url_template` with its transcript_id and the date at the start of its local_time. Times are the location's local time in 24-hour format (14:20).

search_radio

Show one radio conversation to the user as a player: each transmission in order with its time, channel and tail, and a play button for the recording. Use it when the user wants to see, hear or check a specific exchange. The result also lists the transmissions as data; `has_audio` is false where no recording exists. Times are the location's local time in 24-hour format (14:20:05).

show_conversation

The signed-in AirPlx user and the locations (FBOs) whose radio they can read. Call this first when you don't know which location the user means; pass a location's name or airport code as `location` to the other tools.

whoami