NBN Web Services

Example PHP Implementations

• Direct calls using PHP
• Simple .NET wrapper calls

Get Species List

This service returns a list of species. In this example, x,y coordinates and a buffer distance are specified. The list of species returned is restricted by a Taxon Group Key (in this case NHMSYS0000080051 - Echinoderms), a list of current keys can be viewed by clicking here.

Click here to view the source code.

Click here to view the request to the server.

Click here to view the returned XML file.

---

Taxon Group	Scientific name	Common Name

---

Data Providers

Title	Provider	Description

---

Request to Server

POST /ws/webservice HTTP/1.0 Host: www.nbnws.net User-Agent: NuSOAP/0.7.2 (1.94) Content-Type: text/xml; charset=UTF-8 SOAPAction: "http://webservices.searchnbn.net/service/GetSpeciesList" Content-Length: 754 <?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:nbnq="http://webservices.searchnbn.net/query"><SOAP-ENV:Body><SpeciesListRequest xmlns="http://webservices.searchnbn.net/query"> <GeographicalFilter> <Buffer xmlns="http://webservices.searchnbn.net/data"> <Point srs="osgb_BNG" x="247500" y="50500" /> <Distance>1000</Distance></Buffer> </GeographicalFilter> <TaxonReportingCategoryKey>NHMSYS0000080051</TaxonReportingCategoryKey> </SpeciesListRequest></SOAP-ENV:Body></SOAP-ENV:Envelope>

---

Back to the top

---

The Returned XML File

<?xml version="1.0" encoding="utf-8"?>

---

Back to the top

---

Source code for this page

/* * NBN Gateway SOAP Client Sample: * Author: James Perrins, * exeGesIS SDM * 3rd March 2006 */ //pass in details of any proxy server $proxyhost = isset($_POST['proxyhost']) ? $_POST['proxyhost'] : ''; $proxyport = isset($_POST['proxyport']) ? $_POST['proxyport'] : ''; $proxyusername = isset($_POST['proxyusername']) ? $_POST['proxyusername'] : ''; $proxypassword = isset($_POST['proxypassword']) ? $_POST['proxypassword'] : ''; $client = new soapclient("http://212.219.37.104/NBNWebServices/ws/WSDL", 'true', $proxyhost, $proxyport, $proxyusername, $proxypassword); //Increase default timeout. $client->timeout=500; $client->response_timeout=500; $err = $client->getError(); if ($err) { echo '<h2>Constructor error</h2><pre>' . $err . '</pre>'; } $query1 = '<SpeciesListRequest xmlns="http://webservices.searchnbn.net/query"> <GeographicalFilter> <Buffer xmlns="http://webservices.searchnbn.net/data"> <Point srs="osgb_BNG" x="247500" y="50500" /> <Distance>1000</Distance></Buffer> </GeographicalFilter> <TaxonReportingCategoryKey>NHMSYS0000080051</TaxonReportingCategoryKey> </SpeciesListRequest>'; $result = $client->call("GetSpeciesList", $query1); $debug = $client->getDebug(); $obj = simplexml_load_string(fixupxml($client->response)); print ("<hr><table><thead><tr><th>Taxon Group</th><th>Scientific name</th><th>Common Name</th></tr></thead>"); foreach ($obj->SpeciesList->Species as $Species) { echo '<tr><td>', ucfirst($Species->TaxonReportingCategory), '</td><td><i>', $Species->ScientificName, ' (', $Species->Authority, ')</i></td><td>', $Species->CommonName, '</td></tr>'; } print ("</table><hr>"); echo "<h2>Data Providers</h2>"; echo "<table><thead><tr><th>Title</th><th>Provider</th><th>Description</th></tr></thead>"; foreach ($obj->DatasetSummaryList->DatasetSummary as $DataSet) { echo '<tr><td valign="top">', $DataSet->ProviderMetadata->DatasetTitle,'</td><td valign="top">',$DataSet->ProviderMetadata->DatasetProvider, '</td><td>',$DataSet->ProviderMetadata->Abstract->Description, '</td></tr>'; } echo "</table>"; print ("<hr>"); //Debugging code if(isset($_GET["debug"])){ print '<h2>Fixed up XML</h2>'; echo '<xmp>'.fixupxml($client->response).'</xmp>'; print '<h2>Request</h2>'; echo '<xmp>'.$client->request.'</xmp>'; print ("<hr>"); print '<h2>Response</h2>'; echo '<xmp>'.$client->response.'</xmp>'; echo '<hr><h2>Debug</h2><pre>' . $debug . '</pre><hr>'; } echo "<h2>The Returned XML File</h2><pre>"; print htmlspecialchars(fixupxml($client->response)); echo "</pre>";