API Reference
List of available weather ensemble models and elements. When latitude and longitude are provided, only models available for that location are returned.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| lat | string | Optional | - | The latitude of the location |
| lon | number | Optional | - | The longitude of the location |
| Property | Type | Description | |
|---|---|---|---|
models | array | Array of available weather ensemble models | |
└─id | string | Unique identifier for the weather model | |
└─name | string | Human-readable name of the model | |
└─type | string | Type of the model, e.g., 'Ensemble' | |
curl "https://api.infoplaza.dev/v1/marine/ensemble/models? \
api_key=$INFOPLAZA_API_KEY"{
"models": [
{
"id": "ecmwfwamglobalensemble",
"name": "ECMWF Wave Ensemble",
"type": "Ensemble",
"altId": "optimal-wave-ensemble",
"region": "Global",
"members": [
"control",
"member1",
"member2",
"member3",
"member4",
"member5",
"member6",
"member7",
"member8",
"member9",
"member10",
"member11",
"member12",
"member13",
"member14",
"member15",
"member16",
"member17",
"member18",
"member19",
"member20",
"member21",
"member22",
"member23",
"member24",
"member25",
"member26",
"member27",
"member28",
"member29",
"member30",
"member31",
"member32",
"member33",
"member34",
"member35",
"member36",
"member37",
"member38",
"member39",
"member40",
"member41",
"member42",
"member43",
"member44",
"member45",
"member46",
"member47",
"member48",
"member49",
"member50",
"mean",
"median",
"max",
"min",
"percentile10",
"percentile90"
],
"category": "wave",
"elements": [
{
"id": "waveheight_swell",
"name": "Swell height",
"units": [
"m",
"ft"
],
"levels": [],
"unitDefault": "m"
},
{
"id": "waveheight_wind",
"name": "Wind wave height",
"units": [
"m",
"ft"
],
"levels": [],
"unitDefault": "m"
},
{
"id": "waveperiod_swell_secondary",
"name": "Secondary swell period",
"units": [
"s"
],
"levels": [],
"unitDefault": "s"
},
{
"id": "waveperiod_swell",
"name": "Swell period",
"units": [
"s"
],
"levels": [],
"unitDefault": "s"
},
{
"id": "waveperiod_mean",
"name": "Mean wave period",
"units": [
"s"
],
"levels": [],
"unitDefault": "s"
},
{
"id": "wavedirection_wind",
"name": "Wind wave direction",
"units": [
"°"
],
"levels": [],
"unitDefault": "°"
},
{
"id": "waveperiod_peak",
"name": "Wind wave peak period",
"units": [
"s"
],
"levels": [],
"unitDefault": "s"
},
{
"id": "waveheight_swell_secondary",
"name": "Secondary swell height",
"units": [
"m",
"ft"
],
"levels": [],
"unitDefault": "m"
},
{
"id": "wavevector_significant",
"name": "Significant wave vector",
"units": [],
"levels": []
},
{
"id": "wavevector_swell_secondary",
"name": "Secondary swell wave vector",
"units": [],
"levels": []
},
{
"id": "wavedirection_swell_secondary",
"name": "Secondary swell direction",
"units": [
"°"
],
"levels": [],
"unitDefault": "°"
},
{
"id": "wavedirection_swell",
"name": "Swell direction",
"units": [
"°"
],
"levels": [],
"unitDefault": "°"
},
{
"id": "wavedirection_mean",
"name": "Mean wave direction",
"units": [
"°"
],
"levels": [],
"unitDefault": "°"
},
{
"id": "waveheight_significant",
"name": "Significant wave height",
"units": [
"m",
"ft"
],
"levels": [],
"unitDefault": "m"
},
{
"id": "wavevector_swell",
"name": "Swell wave vector",
"units": [],
"levels": []
}
],
"runtimes": [
1780920000,
1780963200
],
"institute": "ECMWF",
"resolution": "40 km"
}
],
"modelCount": 1
}| string |
| Alternative identifier or alias for the model |
└─region | string | Geographical coverage region of the model |
└─members | array | List of ensemble member identifiers for the model |
└─category | string | Category or domain of the model, e.g., 'wave' |
└─elements | array | List of elements (variables) available in the model |
└─id | string | Unique identifier for the element |
└─name | string | Human-readable name of the element |
└─units | array | List of supported units for the element |
└─levels | array | List of atmospheric or oceanographic levels applicable to the element (can be empty) |
└─unitDefault | string | Default unit of measurement for the element's values |
└─runtimes | array | List of runtimes available for the model in Unix timestamp format |
└─institute | string | Institute or organization that produces the model |
└─resolution | string | Spatial resolution of the model grid (e.g., '40 km') |
modelCount | integer | Total number of models returned |