METAR 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.meteomatics.com/mvt/aviation_reports/metar: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	Horizontal visibility Special Case for METAR reports with ///: /// is displayed. Special Case for METAR reports without visibility information: -999 is displayed	in meters
Weather	the reported weather condition (the symbol is only present if the METAR reports a weather condition)	string
Cloud coverage	Cloud coverage in octas Special cases: Cloud Coverage Symbol which is displayed if data is missing: Cloud Coverage Symbol which is displayed when data is not reported: A red symbol for cloud coverage means that one of the following cloud keywords are present: TCU, CB, CBMAM	symbol
Wind barb	Wind speed and direction Special cases: Wind data explicitly not reported in METAR (///): Missing wind data in the report: Note that these special cases are always aligned to the north. This is not an indication for the wind direction.	wind barb symbol
ID	Airport identifier	identifier string
Ceiling	Vertical visibility Special Case CAVOK: If METAR reports CAVOK, instead of the ceiling, CAVOK is displayed. Special Case: /// if METAR Reports ///, /// is displayed. Special Case: -999 If METAR does not report any information about the ceiling, -999 is displayed.	in feet above ground
Temperature/dew point	The reported ambient temperature and dew point. Negative temperatures are displayed by using M as prefix instead of a minus sign.	integer
SPECI	If the report contains the keyword SPECI, it is displayed on the top left of the symbol.	SPECI
Greyed out symbol	If the report is invalid due to timeout (issue time is already older than 1h) the symbols opacity is set to 0.5 to indicate the timeout state.

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 METAR 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
icao	string	-
latitude	double	-
longitude	double	-
issue_time	string	ISO time format string
raw_metar	string	-
wind_speed	double	m/s
wind_direction	double	°
altimeter	string	hPa or "///" (indication that it is explicitly not reported by the METAR)
wind_gust	string	m/s or "///" (indication that it is explicitly not reported by the METAR)