TAF Request

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

https://api-mm.ncm.gov.sa/mvt/aviation_reports/taf:0/style.json?<optionals>

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:

Field	Description	Value	Example
datetime	A date to retrieve the vector data If no datetime is provided, the system defaults to the time of the request.	Dates and times are specified according to the ISO-86011 format (YYYY-MM-DDThh:mm:ssZ). All times are in UTC. Note that the part containing time specifications (Thh:mm:ss) is optional. The default setting is now. For more details see Date/Time Description	2018-04-12T12:45Z
access_token	Instead of basic authentication, you can opt to use OAuth authentication as described here: OAuth Authentification	String.	eyJhbGciOicCI6 ... y2QT4fwpMeJ

Visual Representation

 

What	Description	Unit
Visibility	the horizontal visibility	in meters
Weather	the reported weather condition (the symbol is only present if the TAF reports a weather condition)	string
Cloud coverage	cloud coverage in octas	symbol
Wind barb	wind speed and direction	wind barb symbol
ID	airport identifier	identifier string
CEIL	vertical visibility	in feet above ground

Note: For zoom levels<8, the above symbol is not rendered when using the default style, instead a simple dot is displayed, which indicates the location of available reports.

Further Relevant TAF Informations

Apart from the information represented by the symbol above, we also encode other relevant information into the Protobuf file. These can be extracted and projected on your map by using a custom stylesheet. Here is a list of the additionally available fields:

Key	Data Type	Unit
id	string	-
site	string	-
latitude	double	-
longitude	double	-
issue_time	string	ISO time format string
valid_time_from	string	ISO time format string
valid_time_to	string	ISO time format string
raw_taf	string	-
wind_speed	double	m/s
wind_direction	double	°