Skip to main content

Flightradar client library.

Project description

python-flightradar-client

Build Status Coverage Status

This library provides convenient access to a local Flightradar24 feed.

Installation

pip install flightradar-client

Usage

This library currently support two different flavour of flight data, provided by the fr24feed and dump1090-mutability services that are automatically installed when building your own Pi24 ADS-B receiver.

For each flavour the library provides two modes of access. The *Feed class fetches data once when calling update and transforms it into FeedEntry objects. The *FeedAggregator class keeps a bit of history and with each subsequent update call it tries to fill in any gaps (coordinates and callsign at the moment) missing in the latest data set fetched.

Flightradar Feed

The Flightradar Feed mode uses the JSON data made available by the fr24feed service (normally under http://localhost:8754/flights.json).

FlightradarFlightsFeed and FlightradarFlightsFeedAggregator support the same parameters:

Name Type Description
home_coordinates required, tuple of latitude and longitude Used to calculate the distance to each aircraft.
filter_radius optional, float value in kilometres, default: don't filter by distance Only aircrafts within this radius around the home coordinates are included in the result set.
url optional, full url to access the Pi24 ADS-B receiver JSON, default: construct with hostname and port Define if you have customised access to Pi24 ADS-B receiver or use HTTPS for example.
hostname optional, hostname of the Pi24 ADS-B receiver, default: localhost Define if you are not running this library on your Pi24 ADS-B receiver.
port optional, port of the Pi24 ADS-B receiver's flights service, default: 8754 Define if you have configured a different port on your Pi24 ADS-B receiver.

Feed

import asyncio
import aiohttp
from flightradar_client.fr24feed_flights import FlightradarFlightsFeed
session = aiohttp.ClientSession()
# Home Coordinates: Latitude: -33.5, Longitude: 151.5
feed = FlightradarFlightsFeed((-33.5, 151.5), session)
LOOP = asyncio.get_event_loop()
status, entries = LOOP.run_until_complete(feed.update())

Feed Aggregator

import asyncio
import aiohttp
from flightradar_client.fr24feed_flights import FlightradarFlightsFeedAggregator
session = aiohttp.ClientSession()
# Home Coordinates: Latitude: -33.5, Longitude: 151.5
feed_aggregator = FlightradarFlightsFeedAggregator((-33.5, 151.5), session)
LOOP = asyncio.get_event_loop()
status, entries = LOOP.run_until_complete(feed_aggregator.update())

Dump1090 Feed

The Dump1090 Feed mode uses the JSON data made available by the dump1090-mutability service (normally under http://localhost:8888/data/aircraft.json).

Dump1090AircraftsFeed and Dump1090AircraftsFeedAggregator support the same parameters:

Name Type Description
home_coordinates required, tuple of latitude and longitude Used to calculate the distance to each aircraft.
filter_radius optional, float value in kilometres, default: don't filter by distance Only aircrafts within this radius around the home coordinates are included in the result set.
url optional, full url to access the Pi24 ADS-B receiver JSON, default: construct with hostname and port Define if you have customised access to Pi24 ADS-B receiver or use HTTPS for example.
hostname optional, hostname of the Pi24 ADS-B receiver, default: localhost Define if you are not running this library on your Pi24 ADS-B receiver.
port optional, port of the Pi24 ADS-B receiver's dump1090 service, default: 8888 Define if you have configured a different port on your Pi24 ADS-B receiver.

Feed

import asyncio
import aiohttp
from flightradar_client.dump1090_aircrafts import Dump1090AircraftsFeed
session = aiohttp.ClientSession()
# Home Coordinates: Latitude: -33.5, Longitude: 151.5
feed = Dump1090AircraftsFeed((-33.5, 151.5), session)
LOOP = asyncio.get_event_loop()
status, entries = LOOP.run_until_complete(feed.update())

Feed Aggregator

import asyncio
import aiohttp
from flightradar_client.dump1090_aircrafts import Dump1090AircraftsFeedAggregator
session = aiohttp.ClientSession()
# Home Coordinates: Latitude: -33.5, Longitude: 151.5
feed_aggregator = Dump1090AircraftsFeedAggregator((-33.5, 151.5), session)
LOOP = asyncio.get_event_loop()
status, entries = LOOP.run_until_complete(feed_aggregator.update())

Project details


Release history Release notifications | RSS feed

This version

0.5

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for flightradar-client, version 0.5
Filename, size File type Python version Upload date Hashes
Filename, size flightradar_client-0.5-py3-none-any.whl (26.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size flightradar_client-0.5.tar.gz (12.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page