NCM Logo

Symbols Request

You only need to specify this style URL in your client and it will automatically know what other URLs request for other resources such as vector tiles and weather symbol icons:

https://api-mm.ncm.gov.sa/mvt/symbols/<parameter>/style.json?<optionals>

For example: https://api-mm.ncm.gov.sa/mvt/symbols/weather_symbol_1h:idx/style.json?datetime=todayT0Z

Mandatory Fields

FieldDescriptionValueExample
parameter The parameter for which you want to retrieve the symbols. Available is weather_symbol_<interval>:idx with intervals 20min, 30min, 1h,3h, 6h, 12h, 24h. String with the parameter name and unit separated by either a colon or a slash. weather_symbol_1h:idx, weather_symbol_1h/idx

Optional Fields

Optional fields can be attached to the query string as follows:

https://...?option_name=<option_value>&...

The following table describes all optional parameters:

FieldDescriptionValueExample
datetime Date for which the vector data is retrieved. Date and times (UTC) as specified in the section Date/Time Description. datetime always refers to validdatetime. The default setting is now. datetime=2022-05-28T12:00Z
source This parameter is used to select a specific source (e.g. model) for weather data. String. Default: source=mix ecmwf-ifs, ncep-gfs, ukmo-um10, etc.
resolution Controls the density of weather symbols per tile. Two doubles or two integer: <resolution_lat>,<resolution_lon> or <number_lons>x<number_lats> resolution=0.1,0.1, resolution=400x300
access_token Instead of basic authentication, you can opt to use OAuth authentication as described here: OAuth Authentification String. eyJhbGciOicCI6IkpXVC
J9.eyJzdWIwIiwibmF

tZSI6IkpoxNTE2M
jM5MDIy2QT4fwpMeJ
f36POk6yJV_adQssw5c