Skip to main content

Australian Weather Data (from

Project description

Australian Weather Data (using

Access to the Australian Bureau of Meteorology weather data.

Actions Status PyPI

Currently a work in progress subject to breaking changes!


The purpose of these modules is to fetch weather data from various Australian Bureau of Meteorology websites.

Weather API

Fetches data from the API's at (e.g. Parkville 3-hourly forecast).

This information has been reverse engineered from the beta website with no information about future access arrangements, content or availability.

Example using WeatherApi

import sys
from weather_au import api

w = api.WeatherApi(search='parkville+vic', debug=0)

location = w.location()

# check if the search produced a result (other methods will also return None if the search fails).
if location is None:
    sys.exit('Search failed for location ' + loc)

print(f"\nLocation: {location['name']} {location['state']}, timezone:{location['timezone']}\n")

for warn in w.warnings():
    print(f"Warning short title:  {warn['short_title']}")

    warning = w.warning(id=warn['id'])
    print(f"Warning title:        {warning['title']}")

observations = w.observations()
print(f"\nObservations (temp): {observations['temp']:2}")

forecast_rain = w.forecast_rain()
print(f"Forecast Rain:       amount:{forecast_rain['amount']}, chance:{forecast_rain['chance']}")

print('\n3 Hourly:')
for f in w.forecasts_3hourly():
    print(f"{f['time']} temp:{f['temp']:2}, {f['icon_descriptor']}")

Example using Summary

from weather_au import summary


XML and Scraping


  • observations - fetch XML formatted data from the BOM FTP server.
  • uv_index - fetch the UV data from the XML encoded state based IDZ00107-IDZ00113 products.
  • place - scrape data from location based pages.

Where possible WeatherApi, should be used as it uses an API rather than scraping the web page.

Sample for Parkville in Melbourne Vic Australia

from weather import place, observations, uv_index

# Parse
place_data = place.Place('vic', 'parkville')

station_id = place_data.station_id()
print('Station ID',station_id)

air_temperature = place_data.air_temperature()
print('Air Temperature', air_temperature)

forecast = place_data.forecast()
print('Forecast', forecast)

uv_data = uv_index.UvIndex('Vic')
print('\n' + uv_data.acknowedgment)

location_name = 'Melbourne'
uv_message = uv_data.uv_message(uv_data.get_aac(location_name))

print('UV Message for', location_name, uv_message)


This project is not related to or endorsed by the Australian Bureau of Meteorology (BOM).

From the BOM copyright notice: Where no terms of use are associated with a set of material, then you may download, use and copy that material for personal use, or use within your organisation but you may not supply that material to any other person or use it for any commercial purpose.


Additional examples are in the examples folder.


  • Base for anon FTP data
  • Capital City Observations - VIC - Melbourne (Olympic Park)
    • where IDV60901 is the product, and
    • 95936 is the weather station id.
  • Weather Observations - VIC - Melbourne (Olympic Park)


  1. New weather page
  2. FTP public products
  3. Weather Data Services
  4. How to use BOM API for weather, tide and swell
  5. Github has a number of projects using data
  6. 256 km Melbourne Radar Loop
  7. Catalogue of RSS Feeds

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for weather-au, version 0.0.7
Filename, size File type Python version Upload date Hashes
Filename, size weather_au-0.0.7-py3-none-any.whl (27.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size weather-au-0.0.7.tar.gz (11.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page