Prognoseregionen abrufen

GET https://contrails.googleapis.com/v2/regions: Kontrailstörungsgebiete im GeoJSON-Multipolygon-Format abrufen.

Bei Erfolg ist die Antwort ein FeatureCollection im GeoJSON-Format.

Die zurückgegebenen Regionen zur Vermeidung von Kondensstreifen im Polygonformat werden nach Schweregraden bewertet, die für jede Flughöhe zwischen 1 und 4 liegen. Je höher der Wert, desto schwerwiegender die Kondensstreifen.

Suchparameter

Parameter
time

string

Erforderlich. Uhrzeit der Anfrage.

Format: ISO 8601-Datums-/Uhrzeitstring ODER Unix-Epochen-Ganzzahl

Beispiel: 2026-01-20T21:00:00Z
flightLevel[]

integer

Optional. Zurückzugebende Flugniveaus. Wenn keine Flughöhe angegeben ist, werden alle Flughöhen berücksichtigt.

Format: Flugniveaus in Hektofuß; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440]

Beispiel: [270, 280, 290, 300]
threshold

integer

Optional. Mindestschwellenwert für den Schweregrad. Wenn Sie dieses Feld festlegen, werden nur Regionen mit einem Schweregrad zurückgegeben, der größer oder gleich dem Schwellenwert ist.

Format: Gültige Werte liegen zwischen 1 und 4 (einschließlich).
aircraftClass

string

Optional. Flugzeugklasse. Derzeit wird nur default unterstützt.

Beispiele

  • So rufen Sie alle Regionen zur Vermeidung von Kondensstreifen für einen bestimmten Zeitpunkt ab:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={"time": 2026-01-27T12:00:00Z},
  headers={"x-goog-api-key": API_KEY},
)

    In der GeoJSON-Antwort werden alle Regionen zur Vermeidung von Kondensstreifen im Polygonformat aufgeführt:

    Geometrie flight_level threshold Zeit forecast_reference_time aircraft_class
    0 MULTIPOLYGON Z (((166.25 81.12 8229.6, 168.37 ... 270 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 Standard
    1 MULTIPOLYGON Z (((92.38 45.5 8229.6, 93 46.62 ... 270 2 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 Standard
    2 MULTIPOLYGON Z (((83.38 65 8229.6, 84 66.12 82... 270 3 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 Standard
    3 MULTIPOLYGON Z (((57.38 76 8229.6, 57.75 76.88... 270 4 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 Standard
    4 MULTIPOLYGON Z (((162.38 79 8534.4, 162.75 79.... 280 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 Standard

  • So rufen Sie Regionen zur Vermeidung von Kondensstreifen ab, die auf bestimmte Flughöhen beschränkt sind, wobei die Zeit als Unix-Epochen-Ganzzahl angegeben wird:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 1768942800,
    "flightLevel": [300,310,320,330]
  },
  headers={"x-goog-api-key": API_KEY},
)

  • So rufen Sie Regionen zur Vermeidung von Kondensstreifen ab, die auf bestimmte Flughöhen beschränkt sind und einen Schweregrad von mindestens 3 haben:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 2026-01-27T12:00:00Z,
    "flightLevel": [300,310,320,330],
    "threshold": 3
  },
  headers={"x-goog-api-key": API_KEY},
)