The information on this page is intended for developers and programmers that may wish to extend or improve on the National Broadband Map.   The content on this page assumes knowledge of SOAP APIs and web services.

A core part of the National Broadband Map is the ability for data to be accessed in a number of ways.   This includes the SOAP server from which data can be read and manipulated outside of the mapping application.

WSDL

The WSDL file is available at this URL: http://broadbandmap.govt.nz/soap/v1/wsdl

An example

This example is written in PHP. You should be able to modify it to your own language.

$soap = new SoapClient('http://broadbandmap.govt.nz/soap/v1/wsdl');
// Get all the financial demand points as an XML fragment
$xml = $soap->getXML('DemandCategory', 7, 'Points');
// Parse the resulting XML to get all the organisation titles
$xmlParser = new SimpleXMLElement($xml);
$items = $xmlParser->xpath('//DemandPoint');
foreach($items as $item) {
echo "<p>Demand point: " . $item->OrganisationTtle . "</p>";
}

Data Formats

Currently data can be exposed as XML and JSON.

Security and Permissions

Data can be modified, added and deleted via the SOAP API.  General users have read only access to the data, this is controlled via a user and groups based permissions sytem.   Approval to add, modify or delete data via the SOAP API lies with the SSC.

Demand Categories

These are the demand categories that may be used in conjunction with the SOAP API.  These are subject to change without notice. 

Disclaimer

Developers' and other users' attention is drawn to the terms of the disclaimer.