GET https://contrails.googleapis.com/v2/grids: Eine Übersicht von Kondensstreifenvorhersagen abrufen.
Bei Erfolg ist die Antwort eine NetCDF-Datei mit Werten für die Kondensstreifen-Erwärmung.
Suchparameter
| Parameter | |
|---|---|
time |
Erforderlich. Uhrzeit der Anfrage. Format: ISO 8601-Datums-/Uhrzeitstring ODER Unix-Epochen-Ganzzahl Beispiel: |
bbox[] |
Optional. Grenzen der zurückzugebenden Region. Format: [lng_min, lat_min, lng_max, lat_max] Beispiel: |
aircraftType |
Optional. Flugzeugcode Format: ICAO-Code für Flugzeugtyp mit vier Zeichen Beispiel: |
flightLevel[] |
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: |
format |
Optional. Angefordertes Format Wenn Sie einen anderen Wert als „netcdf4“ übergeben, wird ein UNIMPLEMENTED-Fehler ausgegeben, da Polygone nicht unterstützt werden. |
aircraftClass |
Optional. Flugzeugklasse. Derzeit wird nur |
data[] |
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 Beispiel: |
Beispiele
So rufen Sie das standardmäßige globale 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
contrailsundexpected_effective_energy_forcingbeschrä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}, )