# Historische ADS-B-Daten Archivierte ADS-B-Flüge suchen, Tracks wiedergeben, Verlauf nach Hex-Code oder Kennzeichen abrufen und Flughafenverkehr über 90–365 Tage rekonstruieren. Welchen Endpoint für historische [ADS-B](https://www.faa.gov/air_traffic/technology/adsb)-Daten rufen Sie auf, und welchen Tarif benötigen Sie? Dieser Hub verschafft Ihnen einen Überblick über die Gruppe der archivierten [ADS-B](https://www.faa.gov/air_traffic/technology/adsb)-Daten. Für Live-Positionen siehe [ADS-B](/docs/v31/adsb). **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](/docs/rate-limits#historical-adsb-path-tiers) 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](/docs/v31/historical-adsb-flight-search) | Archivierte Flüge nach Kennzeichen, Hex-Code, Rufzeichen oder Route finden | | `GET /ultra\|mega/history/flight/{flight_id}` | [Details zu einem Flug](/docs/v31/historical-adsb-flight-detail#flight-detail) | Vollständige Metadaten zu einem Flug aus den Suchergebnissen | | `GET /ultra\|mega/history/flight/{flight_id}/track` | [Flug-Track](/docs/v31/historical-adsb-flight-detail#flight-track) | Positionswiedergabe von Gate zu Gate für eine bekannte `flight_id` | | `GET /ultra\|mega/history/positions/{icao24}` | [Positionsverlauf](/docs/v31/historical-adsb-positions) | Rohe Positionsdaten nach Hex-Code des Luftfahrzeugs | | `GET /ultra\|mega/history/positions/registration/{registration}` | [Positionsverlauf](/docs/v31/historical-adsb-positions) | Wie die Abfrage per Hex-Code, akzeptiert jedoch ein Kennzeichen | | `GET /ultra\|mega/history/airport/{icao}/traffic` | [Flughafenverkehr](/docs/v31/historical-adsb-airport-traffic) | 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](/docs/v31/historical-adsb-flight-detail#flight-detail) oder [Track](/docs/v31/historical-adsb-flight-detail#flight-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](/docs/v31/historical-adsb-flight-search#integration). ## Fehlerantworten [#error-responses] Gemeinsame Gateway- und Plattformfehler: [Fehlerbehandlung](/docs/errors). Fehler durch Tarifbeschränkungen gelten für jeden Endpoint dieser Gruppe: ### 401 / 403 — Tarif nicht berechtigt [#401--403--plan-not-entitled] Historische [ADS-B](https://www.faa.gov/air_traffic/technology/adsb)-Daten sind an die Abonnementstufe bei RapidAPI gebunden. Das Gateway kann `401` oder `403` mit einem `message`-String (nicht `detail`) zurückgeben: ```json { "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](/docs/getting-started) | 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 [#integration-guides] | Leitfaden | Inhalt | | ---------------------------------------------------------------------- | ----------------------------------------------- | | [Luftfahrzeugabfrage](/docs/v31/aircraft-lookup-integration) | Kennzeichen, Fotos, Batch-Abfrage | | [Leistungsdaten](/docs/v31/aircraft-performance-integration) | Datenblatt und Typvergleich | | [Live-Tracking](/docs/v31/adsb-integration) | Statistiken, Verkehr in der Nähe, Höhenbänder | | [Historische Tracks](/docs/v31/historical-adsb-integration) | Suche, Detailkette, Flughafenverkehr | | [Fehlerbehandlung](/docs/v31/aircraft-adsb-integration-errors) | `found:false`, Tarifbeschränkungen, leere Feeds | | [Caching & Monitoring](/docs/v31/aircraft-adsb-integration-production) | TTLs, Polling, Tarifstufen | *** Siehe auch: [Live-ADS-B](/docs/v31/adsb) · [Rate Limits](/docs/rate-limits) · [Luftfahrzeugabfrage](/docs/v31/aircraft-lookup)