Metar

This page exists as a landing page to support the Metar WordPress plugin. You may find additional information on our blog by searching the metar tag.

If you’re after specific code you can use in PHP applications, of you’re after a standalone WordPress shortcode function, you’ll want to search our website . This page is intended only to demonstrate usage of the plugin.

Note: All the results on this page are cached for up to a few hours so the data returned is likely invalid.

METAR will accomplish the following:

• Include a METAR or TAF (sourced from the NOAA) website into your page.
• Display temperature or pressure information only.
• Source an Australian TAF and/or METAR from Airsevices Australia.
• Source a list of reports applicable to an Australian ARFOR.

Display a TAF or METAR

If a request is made for an Australian location, the information is sourced from Airservices Australia. Otherwise we’ll request the report from the NOAA (and return it only if the requested station exists ).

A Sydney (YSSY) metar is requested as follows: [metar loc="yssy"]. The result:

TTF METAR YSSY 191500Z 26021KT CAVOK 10/M02 Q1017 RMK RF00.0/000.0 FM1500 MOD/SEV TURB BLW 5000FT

To display a TAF for JFK, we’ll use the shortcode of [taf loc="kjfk"] with a result as follows:

TAF AMD KJFK 191415Z 1914/2018 05014KT P6SM VCSH BKN015 TEMPO 1914/1917 6SM -SHRA BR FM192000 04010KT P6SM VCSH SCT015 BKN025 FM192300 03008KT P6SM SCT025 BKN035 FM201200 04010KT P6SM BKN025

To display a report with the line breaks it was originally published with, use [taf loc="yssy" tidy="0"]. The result:

TAF YSSY 191128Z 1912/2018
24015G25KT CAVOK
FM200000 20020G33KT CAVOK
FM200400 17015KT CAVOK
FM200900 26010KT CAVOK
RMK FM191200 MOD/SEV TURB BLW 5000FT TILL192400
FM200000 MOD TURB BLW 5000FT TILL200400
T 12 10 09 09 Q 1014 1013 1014 1016

By default the report is wrapped in paragraph tags. To disable, use p="0".

Airport Temperature

The temperature (and dew point temperature) on a Metar report is almost always reported in Celsius. The following temperature results are based on data from KJFK. Again, the option to cache your report for longer or shorter than the default hour applies. To cache your report for two hours, use [temperature loc="kjfk" temp="1" cache="7200"], or to cache it for just 30 minutes, use [temperature loc="kjfk" temp="1" cache="1800"].

The bold text in the below results is my own to illustrate the differences between the returned temperatures.

• Temperature (normalised integer °C) is 20 [temperature loc="kjfk" temp="1"]
• Dew Point Temp (normalised integer °C) is 19 [temperature loc="kjfk" temp="2"]
• Raw Temp (from Metar °C) is 20 [temperature loc="kjfk" temp="3"]
• Raw Dew Point Temp (from Metar °C) is 19 [temperature loc="kjfk" temp="4"]
• Temperature (°F) (normalised integer) is 68 [temperature loc="kjfk" temp="5"]
• Dew Point Temp (°F) (normalised integer) is 66 [temperature loc="kjfk" temp="6"]
• Raw report data is 20/19 [temperature loc="kjfk" temp="7"]

In the examples above, the ‘raw’ temperature will return whatever is provided in the report. Negative temperatures will be prefixed with an ‘M’ and single digit temperatures will include a leading ‘0’.

Airport Pressure

To extract the aerodrome pressure from the report, the shortcode of [qnh loc="yssy"] should be used (where yssy is your location of choice). By default, we’ll always return the QNH – not inches of mercury.

The shortcode of [qnh loc="yssy"] will output a QNH of 1017.

A USA METAR report will normally prefix their pressure with an A for altimeter, while it’s Q in most other parts of the world. Since QNH is the ICAO standard, it defaults to true, regardless of what pressure the report provides.

• QNH JFK is 1016 [qnh loc="kjfk"]
• Altimeter JFK is 29.99 [qnh loc="kjfk" unit="0"]

Australian ARFOR Reports

To include all the METAR and TAFs within a specific Australian area, use the shortcode of [arfor loc="21"] (replacing 21 with whatever Australian area you’re querying). The result can be viewed on this page.

Styling the Result

We didn’t want to provide °C or °F extension as a default option because it limits the way in which you can present data. For example, the temperature in Sydney is currently 10°C (50°F) … but I could also just write that it’s currently 10 degrees.

In this example we have a string with the location, temperature, dew-point, and QNH:

The degrees symbol can be created with the string of °. To add it with your shortcode, use [temperature loc="yssy" temp="1" degrees="1"].

Showing Metar Reports in Widgets

There’s are a couple of plugins that don’t do anything other than provide a widget for various reports. We’ve avoided this in the first instance because shortcodes give you more freedom in how you format data and seriously flexibility in where you place it.

Since WordPress doesn’t enable shortcodes in Widget areas by default, we’ve provided an option to enable the functionality. Navigate your way to  Settings  ▶  Metar Shortcode  (once the plugin is activated) and you’ll see the following option.

If your shortcodes are showing up in Widgets as plain text, and only if they’re showing as text (and not rendering a result), select the option to ‘Yes’ and click  Update » .

You then only have to drag a normal text widget into a sidebar, or another location that supports them, and include your shortcode.

Shortcode Attributes

[taf] and [metar]

loc

The four letter ICAO airport code. Must exist in the NOAA database. For Australian locations, most locations are returned.

tidy

Using tidy="1" will remove line breaks and return the report in a single string. Using tidy="0" will retain line breaks. Tidy by default.

p

By default the report will be returned in paragraph tags. If you’re using any data in an inline sentence, use p="0" to remove them. p="1" (true) by default.

cache

The report will cache locally in your WP database for one hour by default (3600 seconds). To alter the cache period, use cache="1800" – where 1800 is the number of seconds; in this case, 30 minutes.

[temperature]

loc

The four letter ICAO airport code. Must exist in the NOAA database. For Australian locations, most locations are returned.

temp

As detailed above, the temp attribute determines what temperature is returned. Returns &degC by default.

degrees

To include the degrees symbol (°) after the returned temperature, use degrees="1". False by default.

cache

The report will cache locally in your WP database for one hour by default (3600 seconds). To alter the cache period, use cache="1800" – where 1800 is the number of seconds; in this case, 30 minutes.

[qnh]

loc

The four letter ICAO airport code. Must exist in the NOAA database. For Australian locations, most locations are returned.

unit

By default all pressures are returned in hectopascals (or as a QNH). To return in inches of mercury, use unit="0"

cache

The report will cache locally in your WP database for one hour by default (3600 seconds). To alter the cache period, use cache="1800" – where 1800 is the number of seconds; in this case, 30 minutes.

[arfor]

loc

The four letter ICAO airport code. Must exist in the NOAA database. For Australian locations, most locations are returned.

cache

The report will cache locally in your WP database for one hour by default (3600 seconds). To alter the cache period, use cache="1800" – where 1800 is the number of seconds; in this case, 30 minutes.

The plugin will invariably be developed over time. Follow us on Facebook for updates.