API Examples

Basic Queries

Single Variable Query

Get cloud cover for a location:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20GFS.ATM.TCDC&time=[now%20TO%201762355295]&location=(32.0000,%2035.000)"

Decoded:

fields=time | GFS.ATM.TCDC
time=[now TO 1762355295]
location=(32.0000, 35.000)

Query with Time Step Interpolation

Get hourly temperature data using STEP for time interpolation:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20location%20|%20GEM.GND2M.TMP&time=[now%20TO%201766620800%20STEP%2060%20minutes]&location=(31,%2035)"

Decoded:

fields=time | location | GEM.GND2M.TMP
time=[now TO 1766620800 STEP 60 minutes]
location=(31, 35)

STEP 60 minutes performs time interpolation to get hourly data points between available model timesteps.

List Available Models

Get list of available models and their last update time:

curl "http://modms.devops.arabiaweather.com/q?fields=model%20|%20last_updated&from=models"

Multiple Variables

Query multiple variables at once:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20GFS.GND2M.TMP%20|%20GFS.GND2M.RH%20|%20GFS.GND10M.UGRD&time=[now%20TO%201762355295]&location=(32.0,%2035.0)"

Decoded:

fields=time | GFS.GND2M.TMP | GFS.GND2M.RH | GFS.GND10M.UGRD
time=[now TO 1762355295]
location=(32.0, 35.0)

Specific Time Range

Query data for a specific time range:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20ICON.SFC.APCP.HR&time=[1762344000%20TO%201762620800]&location=(31.5,%2035.5)"

Decoded:

fields=time | ICON.SFC.APCP.HR
time=[1762344000 TO 1762620800]
location=(31.5, 35.5)

Mathematical Expression Examples

Model Merging

Merge multiple models with fallback:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20merged_temp&time=[now%20TO%201762355295]&location=(32.0,%2035.0)"

Where merged_temp expression: merge(WRFME.ISO850HPA.TMP, GFS.ISO850HPA.TMP) - 273.15

Model Averaging

Average values from multiple models:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20avg_temp&time=[now%20TO%201762355295]&location=(32.0,%2035.0)"

Where avg_temp expression: avg(GFS.ISO500HPA.TMP, UK10.ISO500HPA.TMP) - 273.15

Wind Speed Calculation

Calculate wind speed from U and V components:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20wind_speed&time=[now%20TO%201762355295]&location=(32.0,%2035.0)"

Where wind_speed expression: speed(GFS.GND10M.UGRD, GFS.GND10M.VGRD)

Wind Direction Calculation

Calculate wind direction from U and V components:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20wind_dir&time=[now%20TO%201762355295]&location=(32.0,%2035.0)"

Where wind_dir expression: dir(GFS.GND10M.UGRD, GFS.GND10M.VGRD)

Conditional Expression

Use conditional logic based on conditions:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20dust_prob&time=[now%20TO%201762355295]&location=(32.0,%2035.0)"

Where dust_prob expression:

(LSM.LSM == 0 && speed(GFS.GND10M.UGRD, GFS.GND10M.VGRD) > 7 && GFS.GND2M.RH < 60 && GFS.SFC.APCP.HR <= 0) ? (min(speed(GFS.GND10M.UGRD, GFS.GND10M.VGRD) / 7 * 0.5, 1.0) * GFS.GND2M.RH < 40 ? 100 : (GFS.GND2M.RH * -2.5 + 200)) : 0

Model Median

Get median from multiple models:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20median_wind&time=[now%20TO%201762355295]&location=(32.0,%2035.0)"

Where median_wind expression:

median(speed(EC25.GND10M.UGRD, EC25.GND10M.VGRD), speed(GFS.GND10M.UGRD, GFS.GND10M.VGRD), speed(ICON.GND10M.UGRD, ICON.GND10M.VGRD))

Relative Humidity Calculation

Calculate relative humidity from temperature and dewpoint:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20rh&time=[now%20TO%201762355295]&location=(32.0,%2035.0)"

Where rh expression: rh(GEM.GND2M.TMP, GEM.GND2M.DPT)

Time-Weighted Merge

Merge models based on data freshness:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20merged_wind&time=[now%20TO%201762355295]&location=(32.0,%2035.0)"

Where merged_wind expression: cmerge(time, EC25.GND10M.UGRD, EC25.LASTTIME, ICON.GND10M.UGRD, ICON.LASTTIME, GFS.GND10M.UGRD, GFS.LASTTIME)

Consensus from Multiple Models

Get consensus from multiple model runs:

curl "http://modms.devops.arabiaweather.com/q?fields=time%20|%20consensus_precip&time=[now%20TO%201762355295]&location=(32.0,%2035.0)"

Where consensus_precip expression: consensus(EC25.SFC.APCP.HR*1000, UK10.SFC.TPRATE.HR, GFS.SFC.APCP.HR, ICON.SFC.TPRATE.HR)

Response Format

The API returns JSON data with the requested fields:

{
  "time": [1762355200, 1762358800, ...],
  "location": [[32.0, 35.0], [32.0, 35.0], ...],
  "GFS.ATM.TCDC": [45.2, 48.5, ...]
}

Query Guide - Complete guide to query syntax and capabilities
ModMS Overview - System overview
ModMS Architecture - System architecture

ModMS

MAMS

Pinpoint

Legacy Met Tools

Geos

Geoterra

Basic Queries

Single Variable Query

Query with Time Step Interpolation

List Available Models

Multiple Variables

Specific Time Range

Mathematical Expression Examples

Model Merging

Model Averaging

Wind Speed Calculation

Wind Direction Calculation

Conditional Expression

Model Median

Relative Humidity Calculation

Time-Weighted Merge

Consensus from Multiple Models

Response Format

​Basic Queries

​Single Variable Query

​Query with Time Step Interpolation

​List Available Models

​Multiple Variables

​Specific Time Range

​Mathematical Expression Examples

​Model Merging

​Model Averaging

​Wind Speed Calculation

​Wind Direction Calculation

​Conditional Expression

​Model Median

​Relative Humidity Calculation

​Time-Weighted Merge

​Consensus from Multiple Models

​Response Format

​Related Documentation

Basic Queries

Single Variable Query

Query with Time Step Interpolation

List Available Models

Multiple Variables

Specific Time Range

Mathematical Expression Examples

Model Merging

Model Averaging

Wind Speed Calculation

Wind Direction Calculation

Conditional Expression

Model Median

Relative Humidity Calculation

Time-Weighted Merge

Consensus from Multiple Models

Response Format

Related Documentation