GribStream
Entdecken Sie Datensätze, Parameter und exakte Selektoren, bevor Sie Wetterdaten abrufen. Diese öffentlichen JSON-Endpunkte benötigen kein Token und verbrauchen keine Credits.
Antworten sind fünf Minuten öffentlich zwischenspeicherbar. Die Katalogabdeckung beschreibt das veröffentlichte Produkt; sie garantiert keinen Wert für jeden Ort und Zeitpunkt.
Die Beispiele zeigen ausgewählte Felder und Array-Einträge. Vollständige Antworten können weitere Metadaten, Datensätze, Parameter oder Varianten enthalten. JSON-Feldnamen und Selektorwerte bleiben unverändert.
GET /api/v2/catalog/datasets
Datensätze auflisten; nach code, family, tag oder is_ensemble filtern.
curl 'https://gribstream.com/api/v2/catalog/datasets?code=gfs'Beispielantwort (ausgewählte Felder und Einträge):
[
{
"code": "gfs",
"name": "GFS",
"full_name": "Global Forecast System",
"display_label": "GFS (gfs) - Global Forecast System",
"provider": "NOAA",
"is_ensemble": false,
"parameter_count": 90,
"models_page_url": "/models/gfs",
"api_timeseries_url": "/api/v2/gfs/timeseries",
"api_runs_url": "/api/v2/gfs/runs"
}
]GET /api/v2/catalog/datasets/{dataset}
Datensatzdetails: Abdeckung, Rhythmus, Ensemblemitglieder und Quellen.
curl 'https://gribstream.com/api/v2/catalog/datasets/gfs'Beispielantwort (ausgewählte Felder und Einträge):
{
"code": "gfs",
"name": "GFS",
"provider": "NOAA",
"spatial_resolution": {
"label": "0.25° (~28 km)",
"kind": "latlon"
},
"run_cadence": {
"label": "00/06/12/18 UTC"
},
"min_lead_time": "0h",
"max_lead_time": "384h",
"is_ensemble": false,
"archive_start": "2021-03-22",
"native_grid": {
"total": 1038240,
"grid": {
"type": "regular_latlon",
"nx": 1440,
"ny": 721,
"firstLat": 90,
"firstLon": 0,
"latStep": -0.25,
"lonStep": 0.25,
"longitudeConvention": "zero_to_360"
},
"coordinates_url": "/api/v2/gfs/native-coordinates"
},
"source_url": "https://www.ncei.noaa.gov/products/weather-climate-models/global-forecast"
}Datensatzdetails enthalten native_grid, wenn ein verifiziertes natives Gitter verfügbar ist. grid verwendet dieselbe Spezifikation wie das Koordinateninventar: Geometrie, zutreffende Dimensionen, Längengradkonvention, Projektionsparameter sowie gegebenenfalls Netzkennung oder Genauigkeitsgrenze. Diese Zusammenfassung ist kostenlos und enthält keine Koordinatenpaare.
total ist die vollständige Gittergröße, nicht die Anzahl im Rechteck. Satellitenraster können Positionen außerhalb der Erde enthalten. Nicht zutreffende Dimensionen und Schrittweiten sind null, etwa Dimensionen eines unstrukturierten Netzes; anhand des Gittertyps interpretieren.
Breiten-/Längengradpaare über coordinates_url mit registriertem Token und allen vier Rechteckgrenzen abrufen. Diese Inventarabfrage verbraucht Credits; die Katalogzusammenfassung nicht.
GET /api/v2/catalog/datasets/{dataset}/parameters
Parametergruppen mit Namen, Einheiten und Anzahl der Varianten auflisten.
curl 'https://gribstream.com/api/v2/catalog/datasets/gfs/parameters'Beispielantwort (ausgewählte Felder und Einträge):
[
{
"short_name": "TMP",
"full_name": "Temperature",
"display_label": "TMP - Temperature",
"units": "K",
"variation_count": 57,
"has_code_table": false,
"authoritative_sources": [
{
"label": "NOAA GRIB2 Table 4.2-0-0",
"url": "https://www.nco.ncep.noaa.gov/pmb/docs/grib2/grib2_doc/grib2_table4-2-0-0.shtml"
}
]
}
]GET /api/v2/catalog/datasets/{dataset}/parameters/{parameter}
Varianten, Ebenen, Einheiten und kopierbare Selektoren eines Parameters. Der Parameterpfad unterscheidet Groß- und Kleinschreibung.
curl 'https://gribstream.com/api/v2/catalog/datasets/gfs/parameters/TMP'Beispielantwort (ausgewählte Felder und Einträge):
{
"short_name": "TMP",
"full_name": "Temperature",
"units": "K",
"description": "Air temperature is the thermal state of the atmosphere at the specified level. It influences density, stability, and energy exchange.",
"variations": [
{
"level": "2 m above ground",
"selector": {
"name": "TMP",
"level": "2 m above ground",
"info": ""
},
"selector_literal": "{\"name\":\"TMP\",\"level\":\"2 m above ground\",\"info\":\"\"}",
"introduced_at": "2021-03-22",
"min_lead_time": "0h",
"max_lead_time": "384h"
}
]
}GET /api/v2/catalog/datasets/{dataset}/selectors
Alle exakten Selektoren (name, level, info) in einem flachen Array für Auswahlfelder und Schema-Erkennung.
curl 'https://gribstream.com/api/v2/catalog/datasets/gfs/selectors'Beispielantwort (ausgewählte Felder und Einträge):
[
{
"short_name": "TMP",
"name": "TMP",
"level": "2 m above ground",
"info": "",
"selector": {
"name": "TMP",
"level": "2 m above ground",
"info": ""
},
"selector_literal": "{\"name\":\"TMP\",\"level\":\"2 m above ground\",\"info\":\"\"}"
}
]GET /api/v2/catalog/shared-parameters/{parameter}
Ein gemeinsames Konzept für einen Datensatz auflösen. resolved_request in die Wetterabfrage übernehmen; es kann Variablen und Ausdrücke enthalten. Zuerst resolved_supported prüfen.
curl 'https://gribstream.com/api/v2/catalog/shared-parameters/wind_speed_10m?dataset=ifsoper&alias=wind'Beispielantwort (ausgewählte Felder und Einträge):
{
"code": "wind_speed_10m",
"label": "Wind speed at 10m",
"units": "m/s",
"resolved_dataset": "ifsoper",
"resolved_supported": true,
"resolved_request": {
"variables": [
{
"name": "10u",
"level": "sfc",
"info": "",
"alias": "u_component",
"hidden": true
},
{
"name": "10v",
"level": "sfc",
"info": "",
"alias": "v_component",
"hidden": true
}
],
"expressions": [
{
"expression": "func.Hypot(u_component, v_component)",
"alias": "wind"
}
]
}
}curl 'https://gribstream.com/api/v2/catalog/datasets?family=gfs'
curl 'https://gribstream.com/api/v2/catalog/datasets/gfs/selectors'
curl 'https://gribstream.com/api/v2/catalog/datasets/gfs/parameters/TMP'
curl 'https://gribstream.com/api/v2/catalog/shared-parameters/wind_speed_10m?dataset=ifsoper&alias=wind'Selektoren exakt übernehmen, einschließlich Schreibweise, Leerzeichen und info. Nicht aus Beschreibungen ableiten. Koordinaten und Zeitraum ergänzen und timeseries oder runs mit Ihrem Token aufrufen.
Ungültige Filter ergeben 400, unbekannte Datensätze oder Parameter 404. Erfolgreiche Antworten sind JSON. Vollständige Feld- und Filterschemas stehen in OpenAPI.