ADS-B-Flugzeug-Tracking

Rufen Sie Live-Positionen von Luftfahrzeugen ab, filtern Sie sie für Ihren Kartenausschnitt und prüfen Sie den Zustand des ADS-B-Feeds. ADS-B (Automatic Dependent Surveillance–Broadcast) ist das Transpondersignal, mit dem ein Luftfahrzeug seine Identität und Position aussendet. Jeder Live-Datensatz enthält ICAO24 (sechsstelliger Hex-Code, der den Transponder eines Luftfahrzeugs eindeutig identifiziert, z. B. 0A0022), die Position, die barometrische Höhe (vom Druckhöhenmesser des Luftfahrzeugs gemessene Höhe in Fuß MSL), die Geschwindigkeit über Grund, den Track (Kurs über Grund in Grad rechtweisend) und die Vertikalrate (Steig- bzw. Sinkrate in Fuß pro Minute).

Die Daten werden alle paar Sekunden aktualisiert. Die Paginierung ist optional: Lassen Sie limit weg, um die vollständige Treffermenge zu erhalten (begrenzen Sie die Größe über Filter), oder übergeben Sie limit und offset, um große Ergebnismengen seitenweise abzurufen. Für statische Registerdaten zu einer Hex-Adresse verketten Sie mit der Luftfahrzeugsuche. Für historische Tracks siehe Historisches ADS-B.

Live-Flugzeuge

Liefert die aktuell verfolgten Luftfahrzeuge mit der neuesten Position und den Flugdaten. Jeder Datensatz enthält Position, Höhe, Geschwindigkeit über Grund, Track, Vertikalrate und, sofern verfügbar, Anreicherungsfelder.

Anfrage

Regeln für die Kombination von Filtern — die häufigste Ursache für 422-Fehler:

Kombinieren Sie Höhen- und Geschwindigkeitsfilter, um den Verkehr auf der Strecke herauszufiltern.

Wichtig: photos ist standardmäßig false. photos=true ist langsamer und auf 50 Luftfahrzeuge pro Seite begrenzt — aktivieren Sie die Option nur für Detailansichten, nicht für Kartenkacheln oder hochfrequente Abfragen.

Antwort

{
  "aircraft": [
    {
      "icao24": "0A0022",
      "callsign": "DAH2055",
      "latitude": 51.274109,
      "longitude": -0.675964,
      "altitude": 9075.0,
      "ground_speed": 298.3,
      "track": 153.09,
      "vertical_rate": 2880.0,
      "is_on_ground": false,
      "last_seen": "2026-06-16T14:21:45.674566",
      "first_seen": "2026-06-16T14:17:09.312068",
      "registration": "7T-VJP",
      "aircraft_type": "Boeing B738",
      "airline": "Air Algerie",
      "photo_url": null
    }
  ],
  "total_count": 67,
  "timestamp": "2026-06-16T14:21:49.178448"
}

Luftfahrzeug-Eintrag (aircraft[])

Anreicherungsfelder (registration, aircraft_type, airline) können null sein, wenn die Hex-Adresse nicht im Register enthalten ist oder dem Feed die Verknüpfung zum Rufzeichen fehlt.

curl -X GET "https://data.skylinkapi.com/v3.1/adsb/aircraft"

{
  "aircraft": [
    {
      "icao24": "40621D",
      "callsign": "BAW123",
      "latitude": 51.4706,
      "longitude": -0.4619,
      "altitude": 35000,
      "ground_speed": 450.5,
      "track": 89.2,
      "vertical_rate": 0,
      "is_on_ground": false,
      "last_seen": "2026-02-11T12:00:00Z",
      "first_seen": "2026-02-11T11:45:00Z",
      "registration": "G-STBC",
      "aircraft_type": "Boeing 777-36N",
      "airline": "British Airways",
      "photo_url": "https://image.airport-data.com/aircraft/001912010.jpg"
    }
  ],
  "total_count": 4691,
  "timestamp": "2026-02-11T12:00:30Z"
}

{
  "error": "string",
  "detail": "string",
  "timestamp": "2019-08-24T14:15:22Z"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "string",
  "detail": "string",
  "timestamp": "2019-08-24T14:15:22Z"
}

Tracking-Statistiken

Aggregierte Statistiken über die aktuell verfolgte Flotte — Gesamtzahl der Luftfahrzeuge, Anzahl am Boden vs. in der Luft sowie eine Höhenübersicht. Keine Parameter erforderlich. Nützlich für Monitoring-Dashboards.

Anfrage

Keine Query- oder Pfadparameter.

Antwort

{
  "total_aircraft": 9889,
  "positioned_aircraft": 9889,
  "on_ground": 412,
  "airborne": 9477,
  "altitude_stats": {
    "min_altitude": 100.0,
    "max_altitude": 56600.0,
    "avg_altitude": 21338.04
  },
  "timestamp": "2026-06-16T14:21:50.116343"
}

curl -X GET "https://data.skylinkapi.com/v3.1/adsb/aircraft/statistics"

{}

{
  "error": "string",
  "detail": "string",
  "timestamp": "2019-08-24T14:15:22Z"
}

{
  "error": "string",
  "detail": "string",
  "timestamp": "2019-08-24T14:15:22Z"
}

Dienststatus

Liefert den Verbindungsstatus von ADS-B und die Anzahl aktiver Luftfahrzeuge. Für die Überwachung der Verfügbarkeit und für Vorabprüfungen, bevor Sie den Live-Feed abfragen.

Anfrage

Keine Query- oder Pfadparameter.

Antwort

{
  "status": "healthy",
  "connected": true,
  "active_aircraft_count": 9889,
  "connection_uptime": null,
  "last_message_received": "2026-06-16T14:21:46.212802"
}

curl -X GET "https://data.skylinkapi.com/v3.1/adsb/health"

{
  "status": "string",
  "connected": true,
  "active_aircraft_count": 0,
  "connection_uptime": 0,
  "last_message_received": "2019-08-24T14:15:22Z"
}

{
  "error": "string",
  "detail": "string",
  "timestamp": "2019-08-24T14:15:22Z"
}

{
  "error": "string",
  "detail": "string",
  "timestamp": "2019-08-24T14:15:22Z"
}

Client-Typen

"""ADS-B live aircraft models for GET /adsb/aircraft."""from __future__ import annotationsfrom dataclasses import dataclass@dataclassclass AdsbAircraft:    icao24: str    callsign: str | None    latitude: float | None    longitude: float | None    altitude: float | None    ground_speed: float | None    track: float | None    vertical_rate: float | None    is_on_ground: bool | None    last_seen: str    first_seen: str    registration: str | None    aircraft_type: str | None    airline: str | None    photo_url: str | None@dataclassclass AdsbAircraftListResponse:    aircraft: list[AdsbAircraft]    total_count: int    timestamp: str | None@dataclassclass MapMarker:    """Compact model for map overlays."""    icao24: str    label: str    lat: float    lon: float    altitude_ft: float | None    on_ground: bool

Integration

Fragen Sie Live-Flugzeuge in der Nähe eines Flughafens für eine Verkehrsüberlagerung auf einer Karte ab.

Das folgende Beispiel führt eine Umkreissuche mit Seitenlimit durch, verwendet kurze Timeouts (10 s / 15 s) und bildet die Ergebnisse auf Kartenmarkierungen ab. Cachen Sie Live-Positionen nicht — fragen Sie je nach Kontingent und UX-Anforderungen alle 5–15 Sekunden ab.

import osfrom dataclasses import dataclassimport requestsHEADERS = {    "x-api-key": os.getenv("SKYLINK_API_KEY", "YOUR_API_KEY")}BASE = "https://data.skylinkapi.com/v3.1"@dataclassclass MapMarker:    icao24: str    label: str    lat: float    lon: float    altitude_ft: float | None    on_ground: booldef fetch_aircraft_near(    *,    lat: float,    lon: float,    radius_km: float = 50,    limit: int = 100,) -> dict:    """Fetch live ADS-B aircraft within a radius. Do not cache - data is ephemeral."""    try:        r = requests.get(            f"{BASE}/adsb/aircraft",            headers=HEADERS,            params={                "lat": lat,                "lon": lon,                "radius": radius_km,                "limit": limit,                "photos": False,            },            timeout=(10, 15),        )    except requests.Timeout as exc:        raise RuntimeError("SkyLink timeout fetching ADS-B aircraft") from exc    r.raise_for_status()    return r.json()def to_map_markers(payload: dict) -> list[MapMarker]:    markers: list[MapMarker] = []    for ac in payload.get("aircraft", []):        lat = ac.get("latitude")        lon = ac.get("longitude")        if lat is None or lon is None:            continue        label = ac.get("callsign") or ac.get("registration") or ac["icao24"]        markers.append(            MapMarker(                icao24=ac["icao24"],                label=label,                lat=float(lat),                lon=float(lon),                altitude_ft=ac.get("altitude"),                on_ground=bool(ac.get("is_on_ground")),            )        )    return markersif __name__ == "__main__":    import json    payload = fetch_aircraft_near(lat=40.6413, lon=-73.7781, radius_km=80, limit=5)    print(json.dumps(payload, indent=2, default=str))

Hinweise zur Implementierung

Abfrageintervall. ADS-B-Daten werden alle paar Sekunden aktualisiert. Häufigere Abfragen als etwa alle 5 s verbessern die Aktualität kaum und verbrauchen das Kontingent schnell.

Eingegrenzte Abfragen. Übergeben Sie für Kartenansichten immer lat/lon/radius oder bbox — ungefilterte globale Abfragen können sehr große Payloads liefern.

Paginierung. Verwenden Sie limit + offset beim Rendern von Tabellen. total_count gibt die Größe der aktuellen Seite wieder, nicht die Gesamtzahl der globalen Flotte.

Lücken bei der Anreicherung. registration und aircraft_type können bei militärischen, gesperrten oder nicht registrierten Hex-Codes null sein. Zeigen Sie ersatzweise Rufzeichen und ICAO24 an.

Kette Live → Leistungsdaten. aircraft_type im Live-Feed ist oft eine Marketingbezeichnung (z. B. "Boeing B738"), keine ICAO-Musterbezeichnung. Um Flugzeugleistungsdaten abzurufen, rufen Sie die Luftfahrzeugsuche mit icao24 auf und verwenden aircraft.icao_type aus der Antwort des Registers.

Normalisierung von ICAO24. Akzeptieren Sie sechsstellige Hex-Codes aus ADS-B-Feeds; Groß- und Kleinschreibung sind gleichwertig. Füllen Sie kurze Adressen mit führenden Nullen auf, wenn Ihre Quelle sie weglässt.

Fehlerantworten

Zu plattformweiten Fehlern (Authentifizierung, Rate Limits, Serverfehler) siehe Fehlerbehandlung. Endpointspezifisches Verhalten:

404 — ICAO24-Filter ohne Treffer (Live-Flugzeuge)

Wenn nach icao24 gefiltert wird und kein Luftfahrzeug passt:

{
  "error": "Aircraft not found",
  "detail": "No aircraft found with ICAO24 000000",
  "timestamp": "2026-06-16T14:00:00Z"
}

Gilt nur, wenn icao24 als Filter angegeben ist — nicht bei leeren Umkreissuchen.

422 — ungültige Filterkombination

{
  "detail": [
    {
      "type": "greater_than",
      "loc": ["query", "radius"],
      "msg": "Input should be greater than 0"
    }
  ]
}

Tritt auf, wenn numerische Filter außerhalb des zulässigen Bereichs liegen (zum Beispiel radius ≤ 0 oder eine Höhe außerhalb von 0–60000 ft) oder wenn Kreis- und Bbox-Parameter gemischt werden.

Siehe auch: Luftfahrzeugsuche · Historisches ADS-B · Flugstatus