Prognosegitter abrufen

GET https://contrails.googleapis.com/v2/grids: Ein Raster mit Kondensstreifenvorhersagen abrufen.

Bei Erfolg ist die Antwort ein NetCDF mit Werten für die Kondensstreifen-Erwärmung.

Suchparameter

Parameter
time	string Erforderlich. Uhrzeit der Anfrage. Format: ISO 8601-Datums-/Uhrzeitstring ODER Unix-Epochen-Ganzzahl Beispiel: 2026-01-20T21:00:00Z
bbox[]	number Optional. Grenzen der zurückzugebenden Region. Format: [lng_min, lat_min, lng_max, lat_max] Beispiel: [-40, 20, 20, 60]
aircraftType	string Optional. Flugzeugcode Format: ICAO-Code für den Flugzeugtyp mit vier Zeichen Beispiel: A320
flightLevel[]	integer Optional. Zurückzugebende Flugniveaus. Wenn keine Flughöhe angegeben ist, werden alle Flughöhen berücksichtigt. Format: Flugflächen 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]
format	string Optional. Angefordertes Format Wenn Sie einen anderen Wert als „netcdf4“ übergeben, wird ein UNIMPLEMENTED-Fehler ausgegeben, da Polygone nicht unterstützt werden.
aircraftClass	string Optional. Flugzeugklasse. Derzeit wird nur default unterstützt.
data[]	string Optional. In diesem Feld wird angegeben, welche Datenvariablen in die Antwort aufgenommen werden sollen. Es kann eine oder mehrere Datenvariablen verarbeiten. Wenn dieses Feld leer ist oder nicht angegeben wird, wird standardmäßig ["contrails"] verwendet. Beispiel: ["contrails", "expected_effective_energy_forcing", "persistent_formation_probability", "nominal_cocip_effective_energy_forcing"]

Beispiele

• So rufen Sie das globale Standard-Kondensstreifenraster für einen bestimmten Zeitpunkt ab:

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

  Wenn diese Anfrage mit xarray geladen wird, wird das folgende Dataset zurückgegeben:

  Abmessungen: (Längengrad: 1441, Breitengrad: 721, Flughöhe: 18, Zeit: 1)
  Koordinaten
  Name	Abmessungen	Datentyp	Werte
  longitude	(Längengrad)	float32	-180.0 -179.8 ... 179.8 1...
  latitude	(Breitengrad)	float32	-90,0 -89,75 -89,5 … 8…
  flight_level	(flight_level)	int16	270 280 290 300 … 41…
  Zeit	(Zeit)	datetime64[ns]	2026-01-28T20:00:00
  forecast_reference_time	(Zeit)	datetime64[ns]	2026-01-27T08:00:00
  Datenvariablen
  Kondensstreifen	(Längengrad, Breitengrad, Flughöhe, Zeit)	float32	0,0 0,0 0,0 0,0 … 0,0 …
  Attribute
  inference_pipeli...		contrails.forecast-pipeline_20260115.02_p0
  api_version :		contrails.api-service_20260125.00_p0
  aircraft_class :		Standard

• So rufen Sie ein Raster ab, das auf eine bestimmte geografische Grenze beschränkt und nach einem bestimmten Flugzeugtyp gefiltert ist, wobei die Zeit als Unix-Epochen-Ganzzahl angegeben wird:

  response = requests.get(
    url="https://contrails.googleapis.com/v2/grids",
    params={"time": 1769508160,
            "bbox": [-40, 20, 20, 60],
            "aircraftType": "A320"
            },
    headers={"x-goog-api-key": API_KEY},
  )
  

• So rufen Sie ein Raster ab, das auf eine Teilmenge von Flugniveaus und eine bestimmte Region mit den Layern contrails und expected_effective_energy_forcing beschränkt ist:

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

• Wenn Sie ein Raster mit den Datenvariablen contrails, persistent_formation_probability und nominal_cocip_effective_energy_forcing abrufen möchten:

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