Historische ADS-B-Daten
Welchen Endpoint für historische ADS-B-Daten rufen Sie auf, und welchen Tarif benötigen Sie? Dieser Hub verschafft Ihnen einen Überblick über die Gruppe der archivierten ADS-B-Daten. Für Live-Positionen siehe ADS-B. GPS-Spoofing — die absichtliche Verfälschung des Positionssignals eines Luftfahrzeugs — wird in Flugdatensätzen im Feld gps_spoofing_suspected gekennzeichnet.
Pfadpräfixe (/ultra/history/... vs. /mega/history/...) steuern den Aufbewahrungszeitraum und die Limits pro Anfrage, nicht den Namen Ihres RapidAPI-Tarifs. Unter Rate Limits → Pfadstufen für historische ADS-B-Daten erfahren Sie, welches Abonnement welches Präfix freischaltet.
ULTRA-Pfad (/ultra/history/...) | MEGA-Pfad (/mega/history/...) | |
|---|---|---|
| Max. Zeitraum pro Anfrage | 90 Tage | 365 Tage |
| Max. Flüge pro Anfrage | 1.000 | 2.000 |
| Max. Positionen pro Anfrage | 5.000 | 10.000 |
| Max. Track-Positionen | standardmäßig 2.000 | standardmäßig 5.000 |
| RapidAPI-Tarife | Pro, Ultra, Mega | Ultra, Mega |
| Endpoint | Seite | Verwendung |
|---|---|---|
GET /ultra|mega/history/flights | Suche im Flugverlauf | Archivierte Flüge nach Kennzeichen, Hex-Code, Rufzeichen oder Route finden |
GET /ultra|mega/history/flight/{flight_id} | Details zu einem Flug | Vollständige Metadaten zu einem Flug aus den Suchergebnissen |
GET /ultra|mega/history/flight/{flight_id}/track | Flug-Track | Positionswiedergabe von Gate zu Gate für eine bekannte flight_id |
GET /ultra|mega/history/positions/{icao24} | Positionsverlauf | Rohe Positionsdaten nach Hex-Code des Luftfahrzeugs |
GET /ultra|mega/history/positions/registration/{registration} | Positionsverlauf | Wie die Abfrage per Hex-Code, akzeptiert jedoch ein Kennzeichen |
GET /ultra|mega/history/airport/{icao}/traffic | Flughafenverkehr | Historische Ankünfte und Abflüge an einem Flughafen |
Wahl des Pfads. Abonnenten von Pro verwenden ausschließlich /ultra/history/... (Zeiträume von 90 Tagen). Ultra und Mega können beide Präfixe aufrufen: Verwenden Sie /ultra/history/... für Rückblicke von bis zu 90 Tagen oder /mega/history/..., wenn Sie bis zu 365 Tage oder höhere Limits pro Anfrage benötigen. Der Server gibt 422 zurück, wenn Ihr Datumsbereich die Obergrenze des Pfads überschreitet — z. B. wird ein Zeitraum von 120 Tagen bei /ultra/history/... selbst mit einem Ultra-Abonnement abgelehnt.
Ablauf. Die typische Kette lautet Suche → Details (Metadaten) oder Suche → Track (Wiedergabe auf der Karte). Suchen Sie mit mindestens einem Filter, übernehmen Sie eine flight_id aus den Ergebnissen und rufen Sie dann Details oder Track auf. Details oder Track können Sie nicht ohne eine flight_id aus der Suche aufrufen. Ein ausführbares Beispiel finden Sie unter Suche im Flugverlauf → Integration.
Fehlerantworten
Gemeinsame Gateway- und Plattformfehler: Fehlerbehandlung. Fehler durch Tarifbeschränkungen gelten für jeden Endpoint dieser Gruppe:
401 / 403 — Tarif nicht berechtigt
Historische ADS-B-Daten sind an die Abonnementstufe bei RapidAPI gebunden. Das Gateway kann 401 oder 403 mit einem message-String (nicht detail) zurückgeben:
{
"message": "This endpoint is disabled for your subscription"
}| Situation | Lösung |
|---|---|
| Basic oder FREE Trial | Upgrade auf Pro oder höher für /ultra/history/... |
Tarif Pro ruft /mega/history/... auf | Upgrade auf Ultra oder Mega oder Wechsel zu /ultra/history/... |
| Fehlende Header | X-RapidAPI-Key und X-RapidAPI-Host hinzufügen — siehe Erste Schritte |
Wiederholen Sie 401/403 nicht — korrigieren Sie das Abonnement oder das Pfadpräfix.
Endpoint-spezifische Fehler (404 für Flug, 404 für Kennzeichen, 422 für Filter/Zeitraum/Inkonsistenz) sind auf den entsprechenden Referenzseiten dokumentiert.
Integrationsleitfäden
| Leitfaden | Inhalt |
|---|---|
| Luftfahrzeugabfrage | Kennzeichen, Fotos, Batch-Abfrage |
| Leistungsdaten | Datenblatt und Typvergleich |
| Live-Tracking | Statistiken, Verkehr in der Nähe, Höhenbänder |
| Historische Tracks | Suche, Detailkette, Flughafenverkehr |
| Fehlerbehandlung | found:false, Tarifbeschränkungen, leere Feeds |
| Caching & Monitoring | TTLs, Polling, Tarifstufen |
Siehe auch: Live-ADS-B · Rate Limits · Luftfahrzeugabfrage
ADS-B-Flugzeug-Tracking
ADS-B-Positionen von Luftfahrzeugen in Echtzeit mit geografischen Filtern, Flottenstatistiken und Ingestion-Status für Live-Tracking-Integrationen.
Suche im Flugverlauf
Archivierte ADS-B-Flüge nach Kennzeichen, ICAO24-Hex, Rufzeichen oder Route suchen – liefert flight_id-UUIDs für Detail- und Track-Abfragen.