GET https://contrails.googleapis.com/v2/grids: otrzymywanie siatki prognoz dotyczących śladów kondensacyjnych.
Jeśli operacja się uda, odpowiedź będzie zawierać plik NetCDF z wartościami wymuszania kondensacji.
Parametry zapytania
| Parametry | |
|---|---|
time |
Wymagane. Czas przesłania żądania. Format: ciąg daty i godziny w formacie ISO 8601 LUB liczba całkowita epoki systemu Unix Przykład: |
bbox[] |
Opcjonalnie. Granice regionu do zwrócenia. Format: [lng_min, lat_min, lng_max, lat_max] Przykład: |
aircraftType |
Opcjonalnie. Kod samolotu. Format: 4-znakowy kod ICAO typu samolotu Przykład: |
flightLevel[] |
Opcjonalnie. Poziomy lotu do zwrócenia. Jeśli nie podasz poziomu lotu, zostaną uwzględnione wszystkie poziomy. Format: poziomy lotu w hektostopach; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440] Przykład: |
format |
Opcjonalnie. Żądany format. Przekazanie wartości innej niż „netcdf4” spowoduje zgłoszenie błędu UNIMPLEMENTED, ponieważ wielokąty nie są obsługiwane. |
aircraftClass |
Opcjonalnie. Klasa samolotu. Obecnie obsługiwana jest tylko forma |
data[] |
Opcjonalnie. To pole określa, które zmienne danych mają zostać uwzględnione w odpowiedzi. Może obsługiwać jedną lub kilka zmiennych danych.
Jeśli to pole jest puste lub nie zostało podane, domyślna wartość to Przykład: |
Przykłady
Aby pobrać domyślną globalną siatkę smug kondensacyjnych dla określonego momentu:
response = requests.get( url="https://contrails.googleapis.com/v2/grids", params={"time": 2026-01-27T12:00:00Z}, headers={"x-goog-api-key": API_KEY}, )Po wczytaniu za pomocą biblioteki xarray to żądanie zwraca ten zbiór danych:
Wymiary: (longitude: 1441, latitude: 721, flight_level: 18, time: 1) Współrzędne Nazwa Wymiary Typ danych Wartości longitude (długość geograficzna) float32 -180.0 -179.8 ... 179.8 1... latitude (szerokość geograficzna) float32 -90,0 -89,75 -89,5 ... 8... flight_level (flight_level) int16 270 280 290 300 ... 41... czas (czas) datetime64[ns] 2026-01-28T20:00:00 forecast_reference_time (czas) datetime64[ns] 2026-01-27T08:00:00 Zmienne danych smugi kondensacyjne, (długość geograficzna, szerokość geograficzna, poziom lotu, czas) float32 0.0 0.0 0.0 0.0 ... 0.0 ... Atrybuty inference_pipeli... contrails.forecast-pipeline_20260115.02_p0 api_version : contrails.api-service_20260125.00_p0 aircraft_class : domyślna Aby pobrać siatkę ograniczoną do określonego obszaru geograficznego i przefiltrowaną pod kątem określonego typu samolotu, z czasem określonym jako liczba całkowita epoki systemu Unix:
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}, )Aby pobrać siatkę ograniczoną do podzbioru poziomów lotu i określonego regionu z warstwami
contrailsiexpected_effective_energy_forcing: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}, )