We’ve provided code to retrieve aviation airport METAR and TAF forecasts in the past, but they’ve used the NOAA Government database so didn’t include Australian (non-RPT) aerodromes. The shortcode on this page, however, will permit you to:
- Include an Australian TAF and/or METAR report in a WordPress post or page.
- Include all Australian METAR and TAF reports for an entire area (ARFOR) in a WP post or page.
- Extract just the temperature, dewpoint temperature, or QNH, for a particular location, and display it.
What is a METAR and TAF? METAR and TAF reports are weather observations written in a global format standardised by the International Civil Aviation Organization (ICAO). Aircrew and operations departments usually make fuel and other operational determinations based on the actual observation (Metar) or the short-term forecase (TAF). The area forecast includes wind information, temperature, cloud, and other weather data that assists in route planning.
METAR WordPress Plugin
If you’re using our Metar WordPress plugin, continue to use it. METAR 
will be updated very shortly to include other data… and it’ll be entirely rewritten (it hasn’t changed in years). The plugin is a sensible alternative to shortcode because of the ease in which it’ll be updated.
The Result
To display the METAR for Bankstown (YSBK) we’ll use the shortcode of [bom loc="ysbk" type="metar"]. The result (in a blockquote for style purposes) is as follows:
SPECI YSBK 132000Z AUTO 00000KT 9999 // SCT010 OVC017 20/19 Q1001 RMK RF00.0/028.8
To display the TAF for Sydney (YSSY) we’ll use the shortcode of [bom loc="yssy" type="taf"]. By default we’ll remove line breaks and present the report inline. The result is as follows:
TAF AMD YSSY 131639Z 1318/1424 17006KT 9999 -SHRA FEW010 SCT020 FM132300 07010KT 9999 -SHRA SCT025 FM140500 04015KT 9999 -SHRA SCT030 FM140900 01010KT 9999 -SHRA SCT010 BKN020 FM142300 05015KT 9999 -SHRA SCT010 BKN020 INTER 1318/1323 5000 SHRA BKN010 TEMPO 1412/1414 5000 SHRA BKN008 PROB30 TEMPO 1404/1412 VRB25G35KT 3000 TSRA SCT010 FEW025CB RMK T 21 24 26 27 Q 999 1001 1002 1001
Some prefer to display the TAF report raw with line breaks and formatting retained (as intended). To do so, use [bom loc="yssy" type="taf" tidy="0"]. The result:
TAF AMD YSSY 131639Z 1318/1424
17006KT 9999 -SHRA FEW010 SCT020
FM132300 07010KT 9999 -SHRA SCT025
FM140500 04015KT 9999 -SHRA SCT030
FM140900 01010KT 9999 -SHRA SCT010 BKN020
FM142300 05015KT 9999 -SHRA SCT010 BKN020
INTER 1318/1323 5000 SHRA BKN010
TEMPO 1412/1414 5000 SHRA BKN008
PROB30 TEMPO 1404/1412 VRB25G35KT 3000 TSRA SCT010 FEW025CB
RMK
T 21 24 26 27 Q 999 1001 1002 1001
We have the option of displaying limited meta data (basically, data within the data forecast string) in isolation. The function provides for the rendering of just the QNH, temperature, or dewpoint temperature.
To display the QNH (pressure) for a particular location, use [bom loc="ysbk" meta="q"]; for temperature, use [bom loc="ysbk" meta="t"], and for dewpoint temperature use [bom loc="ysbk" meta="d"]. While the default output will be just 1001, 20, and 19, a little bit of style can jazz it up a little.
YSBK Q1001 T20 DP19
On a couple of our sites (not necessarily aviation), we display the temperature for specific Australian locations. We cache data for up to a couple of hours to avoid unnecessary requests to the BOM.. The following data isn’t valid – it’s just designed to illustrate a point.
SYD 21°C BNE 23°C MEL 14°C
It’s important to leave the meta attribute empty by default, or when not required. When used it’ll force a METAR to be returned rather than any other report that might be requested.
To request all (unformatted and raw) reports for a particular area, use [bom loc="21"] (where 21 is Area 21). The example result is printed on this page.
WordPress Shortcode
Copy and paste the WordPress function into your theme's functions.php file or, if you sensibly have one installed, your custom functions plugin. You may optionally download and install our plugin from the bottom of of the page.
The first function randomly selects a user agent to emulate a broswer making the request. The function isn’t intended to circumvent detection by the BOM (from what might be seen as abuse), but rather simply to emulate a browser request to ensure data is returned correctly.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
/* Generates a random user agent for CURL request Embed an Australian METAR or TAF into Your Website with WordPress Shortcode or PHP http://www.beliefmedia.com/australia-metar-taf-wordpress */ function beliefmedia_random_useragent() { $userAgents=array( "Mozilla/5.0 (Windows; U; Windows NT 5.1; en-GB; rv:1.8.1.6) Gecko/20070725 Firefox/2.0.0.6", "Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1)", "Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727; .NET CLR 3.0.04506.30)", "Opera/9.20 (Windows NT 6.0; U; en)", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; en) Opera 8.50", "Mozilla/4.0 (compatible; MSIE 6.0; MSIE 5.5; Windows NT 5.1) Opera 7.02 [en]", "Mozilla/5.0 (Macintosh; U; PPC Mac OS X Mach-O; fr; rv:1.7) Gecko/20040624 Firefox/0.9", "Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/48 (like Gecko) Safari/48", "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2228.0 Safari/537.36", "Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 7.0; InfoPath.3; .NET CLR 3.1.40767; Trident/6.0; en-IN)", "Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; WOW64; Trident/6.0)", "Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; Trident/6.0)", "Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; Trident/5.0)", "Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; Trident/4.0; InfoPath.2; SV1; .NET CLR 2.0.50727; WOW64)", "Mozilla/5.0 (compatible; MSIE 10.0; Macintosh; Intel Mac OS X 10_7_3; Trident/6.0)", "Mozilla/4.0 (Compatible; MSIE 8.0; Windows NT 5.2; Trident/6.0)", "Mozilla/4.0 (compatible; MSIE 10.0; Windows NT 6.1; Trident/5.0)", "Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; rv:11.0) like Gecko", "Mozilla/1.22 (compatible; MSIE 10.0; Windows 3.1)" ); /* Select random agent */ $random = rand(0,count($userAgents)-1); return $userAgents[$random]; } |
The second function makes a request to the BOM server and, depending upon whether you would like a METAR/TAF or ARFOR, will return the appropriate array or result.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 |
/* Retrieve the forecast from BOM Embed an Australian METAR or TAF into Your Website with WordPress Shortcode or PHP http://www.beliefmedia.com/australia-metar-taf-wordpress */ function beliefmedia_get_bom_data($loc) { /* Create CURL Request */ $post_data = 'keyword=' . $loc . '&type=search&page=TAF'; $ch = curl_init(); curl_setopt($ch,CURLOPT_URL, 'http://www.bom.gov.au/aviation/php/process.php'); curl_setopt($ch,CURLOPT_RETURNTRANSFER, true); curl_setopt($ch,CURLOPT_HEADER, false); curl_setopt($ch, CURLOPT_POST, count($post_data)); curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data); curl_setopt($ch,CURLOPT_USERAGENT, beliefmedia_random_useragent()); $result = curl_exec($ch); curl_close($ch); /* Match forecasts */ if (!ctype_digit($loc)) { preg_match_all('/<p class="product">(.*?)<\/p>/si', $result, $match); return (array) $match; } else { return $result; } } |
The next two functions take a METAR report and extract either the temperature, dew-point temperature, or QNH.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
/* Isolates the temperature and QNH from forecast Embed an Australian METAR or TAF into Your Website with WordPress Shortcode or PHP http://www.beliefmedia.com/australia-metar-taf-wordpress */ function beliefmedia_bom_forecast_qnh($forecast) { preg_match('/(A|Q)([0-9]{4})/', $forecast, $results); $altimeter_raw = $results['2']; return $altimeter_raw; } function beliefmedia_bom_forecast_temps($forecast) { preg_match('/(M?[0-9]{2})\/(M?[0-9]{2}|[X]{2})/', $forecast, $results); $tempC = $results[1]; $dpC = $results[2]; $temparray = array($tempC, $dpC); return $temparray; } |
The last function is the working WordPress shortcode function. If you’re using the function outside of WordPress, this is the only function you won’t include (instead using the similar function below).
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 |
/* WordPress Shortcode Function Embed an Australian METAR or TAF into Your Website with WordPress Shortcode or PHP http://www.beliefmedia.com/australia-metar-taf-wordpress */ function beliefmedia_bom_forecast($atts) { $atts = shortcode_atts(array( 'loc' => 'YSBK', 'type' => 'TAF', 'tidy' => 1, 'p' => 1, 'meta' => '', /* q - qnh, t - temp, d - dewpoint */ 'cache_temp' => 600, 'cache' => 3600 ), $atts); $atts = array_map('strtoupper', $atts); if ($atts['meta'] != '') $atts['type'] = 'METAR'; /* If area forecast, returning raw data */ if (ctype_digit($loc)) { $atts['type'] = 'ARFOR'; $atts['tidy'] = 0; $atts['p'] = 0; } $transient = (is_numeric($atts['type'])) ? 'bmom_' . md5($atts['loc'] . $atts['cache'] . $atts['type']) : 'bmom_' . md5($atts['loc'] . $atts['cache']); $cachedresult = get_transient($transient); if ($cachedresult !== false) { $bom = $cachedresult; } else { /* Get BOM weather data */ $return = beliefmedia_get_bom_data($atts['loc']); if ($atts['type'] != 'ARFOR') { /* We'll cache all reports */ $bom = array(); $bom['metar'] = $return[1][1]; $bom['taf'] = $return[1][0]; } else { /* Arfor string */ $bom = $return; } /* Cache and return data */ set_transient($transient, $bom, $atts['cache']); } /* What to return? */ switch ($atts['type']) { case 'TAF': $forecast = $bom['taf']; break; case 'METAR': $forecast = $bom['metar']; break; case 'ARFOR': $forecast = $bom; break; } /* Tidy up the forecast if required */ if ($atts['tidy']) $forecast = str_replace('<br />', ' ', $forecast); if ($atts['p']) $forecast = '<p>' . $forecast . '</p>'; /* If temp or QNH */ if ($atts['meta'] != '') { switch ($atts['meta']) { case 'Q': $forecast = beliefmedia_bom_forecast_qnh($forecast); break; case 'T': $temparray = beliefmedia_bom_forecast_temps($forecast); $forecast = $temparray['0']; break; case 'D': $temparray = beliefmedia_bom_forecast_temps($forecast); $forecast = $temparray['1']; break; } } return $forecast; } add_shortcode('bom', 'beliefmedia_bom_forecast'); |
If you require shortcode to work in a sidebar widget, you'll have to enable the functionality with a filter. If you're using our custom functions plugin, you'll have that feature enabled by default.
Shortcode Attributes
loc
loc="ybbn", Sydney is loc="yssy", and Temora is loc="ytem". To request the full Metar/TAF report summary for an area forecast, use loc="21".
type
type defaults to TAF. To render a METAR report for Camden, use loc="yscn" type="metar".tidy
tidy="0".p
p tags, use p="0".cache
PHP Function
Used outside of WordPress, the following may be used. All other functions above are required except for the shortcode function. Usage of Simple Cache is required.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 |
/* PHP Function Embed an Australian METAR or TAF into Your Website with WordPress Shortcode or PHP http://www.beliefmedia.com/australia-metar-taf-wordpress */ function beliefmedia_bom_forecast($args) { $atts = array( 'loc' => 'YSBK', 'type' => 'TAF', 'tidy' => 1, 'p' => 1, 'meta' => '', /* q - qnh, t - temp, d - dewpoint */ 'cache' => 3600 ); /* Merge $args with $atts */ $atts = (empty($args)) ? $atts : array_merge($atts, $args); $atts = array_map('strtoupper', $atts); if ($atts['meta'] != '') $atts['type'] = 'METAR'; /* If area forecast, returning raw data */ if (ctype_digit($loc)) { $atts['type'] = 'ARFOR'; $atts['tidy'] = 0; $atts['p'] = 0; } $transient = (is_numeric($atts['type'])) ? 'bm_bom_weather_' . md5($atts['loc'] . $atts['cache'] . $atts['type']) : 'bm_bom_weather_' . md5($atts['loc'] . $atts['cache']); $cachedresult = beliefmedia_get_transient($transient, $atts['cache']); if ($cachedresult !== false) { $bom = $cachedresult; } else { /* Get BOM weather data */ $return = beliefmedia_get_bom_data($atts['loc']); if ($atts['type'] != 'ARFOR') { /* We'll cache all reports */ $bom = array(); $bom['metar'] = $return[1][1]; $bom['taf'] = $return[1][0]; } else { /* Arfor string */ $bom = $return; } /* Cache and return data */ beliefmedia_set_transient($transient, $bom); } /* What to return? */ switch ($atts['type']) { case 'TAF': $forecast = $bom['taf']; break; case 'METAR': $forecast = $bom['metar']; break; case 'ARFOR': $forecast = $bom; break; } /* Tidy up the forecast if required */ if ($atts['tidy']) $forecast = str_replace('<br />', ' ', $forecast); if ($atts['p']) $forecast = '<p>' . $forecast . '</p>'; /* If temp or QNH */ if ($atts['meta'] != '') { switch ($atts['meta']) { case 'Q': $forecast = beliefmedia_bom_forecast_qnh($forecast); break; case 'T': $temparray = beliefmedia_bom_forecast_temps($forecast); $forecast = $temparray['0']; break; case 'D': $temparray = beliefmedia_bom_forecast_temps($forecast); $forecast = $temparray['1']; break; } } return $forecast; } /* Usage */ $args = array('loc' => 'YSSY'); echo beliefmedia_bom_forecast($args); $args = array('loc' => 'YSBK', 'type' => 'TAF', 'tidy' => 1, 'p' => 1, 'meta' => '', 'cache' => 3600); echo beliefmedia_bom_forecast($args); |
Considerations
- Our METAR WP Plugin will have the feature to pull out winds and other information so, once again, it’s a safer and more feature-rich choice.
- The BOM has a copyright policy here
. Generally speaking, and not unlike the NOAA, Government departments are required to provide data on the condition that attribution is provided. The Bureau must be identified as the source of the material and a prominent link included to the BOM web page from which the material was sourced. Any copyright statement or logo included on, or in connection with, a set of material must be retained. All text or graphical re-presentation of forecasts must include the issue time and date and the validity of the period and must precisely reproduce any warnings associated with the material. It is up to the user to determine if usage of our code contravenes BOM policy or if a User Agreement is required.
- Upon entering the BOM aviation site, the organisation makes it clear that any operational information should be obtained from AirServices Australia
… and you should do the same. Attribution and standard disclaimers should apply. The reports rendered by virtue of the code on the page should be considered entertainment at best.
- When querying all reports in an Area, the returned text includes all airport titles in
h3tags. You could alter this by using a simplestr_replace('h3', 'h4', $forecast);or something similar if you wanted to alter the way it presents. A regular expression might be used to remove them completely. - To display the degrees symbol and Celsius sign (°C), use the HTML entity of
°C.
Download
Shortt URL for this post: http://shor.tt/1XO9
