BioNet Web Services

About

BioNet is the trusted source of biodiversity data for the state of NSW and a resource for all. As a part of OEH’s Open OEH initiative, data held in BioNet has been made available via an Open Application Programming Interface (API). This enables organisations and individuals to directly integrate biodiversity data into their software systems and unlock the innovation potential of this valuable data asset.

By delivering this data via an Open API we are aiming to improve environmental decision making through integration of up to date, consistent and reliable biodiversity data in planning and decision making systems.

What data have you made available via your API?

Release 3.0 of the API (https://data.bionet.nsw.gov.au/biosvcapp/odata) makes the following BioNet data collections available:

  • Species Sightings
  • Vegetation Classification
  • NSW Landscapes
  • Threatened Biodiversity
  • Species Names

In addition, it provides a new thesaurus service for IT developers to enhance search functionality in software apps.

For more detailed information on the capabilities and features of the API see the following Release Notes:

Data is shared according to the following published standards which provide information on the field names, definitions, formats and any restrictions that might apply to specific fields:

I am an IT developer and would like to use your API

Step 1: To help you get started and issue you an application token, please download and complete the Data Use Case Form and email it to BioNet. While this step is not mandatory, it will enable us to better support your development efforts.

Step 2: Read the Developer Guide (PDF 459KB) to understand how we have implemented OData for BioNet Web Services and follow our best practice guidelines.

To help reduce the development effort required to integrate the data, we chose an open global API standard (OASIS OData Version 4.0). There are many existing online OData communities and resources for developers and we recommend you search the internet to see if there are existing resources for your development tools and platform. To help you get started, here are some useful links to core resources:

Documentation on the OData Standard

OData resources including software libraries and tools

I want to access the data but I am not an IT developer

The data made available through the web services are the same data that are currently available through the BioNet web applications. Unless you have a specific need that is not currently met via our web application, we recommend you access the data via the BioNet Atlas or the BioNet Vegetation Classification user interfaces.

If you have a need to create customised downloads, there are a number of desktop applications that support our API which is based on the Open Data Protocol (OData) version 4.0. A list of some of the tools available can be found at: OData.org Ecosystem.

For users of Excel 2010 or later version,we have prepared the following quick guide:

Page last updated: 04 October 2017