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:
METAR YSBK 181300Z AUTO 25007KT 9999 // BKN047 BKN056 BKN120 11/05 Q1020 RMK RF00.0/000.0
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 YSSY 181120Z 1812/1918 21020G30KT 9999 -SHRA FEW015 SCT025 BKN040 FM190000 18020G30KT 9999 -SHRA SCT030 BKN045 FM191000 21015G25KT 9999 -SHRA SCT030 BKN045 INTER 1812/1912 4000 SHRA BKN010 RMK FM181200 MOD TURB BLW 5000FT TILL190600 T 12 11 11 13 Q 1019 1019 1018 1020
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 YSSY 181120Z 1812/1918
21020G30KT 9999 -SHRA FEW015 SCT025 BKN040
FM190000 18020G30KT 9999 -SHRA SCT030 BKN045
FM191000 21015G25KT 9999 -SHRA SCT030 BKN045
INTER 1812/1912 4000 SHRA BKN010
RMK FM181200 MOD TURB BLW 5000FT TILL190600
T 12 11 11 13 Q 1019 1019 1018 1020
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 1020, 11, and 05, a little bit of style can jazz it up a little.
YSBK Q1020 T11 DP05
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 12°C BNE 12°C MEL 06°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
