WoRMS banner
Add search provider Add provider
Twitter: Latest updates @WRMarineSpecies

Life Science Identifier (LSID)

LSIDs are persistent, location-independent, resource identifiers for uniquely naming biologically significant resources.
The LSID concept introduces a straightforward approach to naming and identifying data resources stored in multiple, distributed data stores in a manner that overcomes the limitations of naming schemes in use today [more information].

WoRMS has implemented LSIDs for all its taxonomic names and they are displayed on each taxon page. We have integrated the AphiaID into the LSID, so in fact you can continue using the AphiaID.

For example: the LSID for Solea solea is: urn:lsid:marinespecies.org:taxname:127160
You can resolve an LSID via the various services available.
Example for Solea solea: http://lsid.tdwg.org

The returned model is RDF (XML) with metadata elements from Darwin Core and Dublin Core.

Vocabularies using a WoRMS unique identifier



[Back]

Calling the WoRMS webservice from PHP4

This tutorial assumes you are using any webserver with PHP4 installed and working properly.

Step 1: Download the NuSOAP Library

Download the latest version 0.9.5 (nusoap-0.9.5.zip) from SourceForge.
Exctract the package in the directory "nusoap"


Step 2: Paste the following code in a .php file (this is just an example)
 require_once("nusoap/nusoap.php");
 $client = new SoapClient("http://marinespecies.org/aphia.php?p=soap");
 $AphiaID = $client->call("getAphiaID", array("scientificname" => "solea solea"));
 $taxon  = $client->call("getAphiaRecordByID", array("AphiaID" => $AphiaID));
 echo "<b>AphiaID</b>: ".$taxon["AphiaID"]."<br />\n";
 echo "<b>Displayname</b>: ".$taxon["scientificname"]." ".$taxon["authority"]."<br />\n";
 echo "<b>URL</b>: ".$taxon["url"]."<br />\n";
 echo "<b>Accepted name</b>: ".$taxon["valid_name"]." ".$taxon["valid_authority"]."<br />\n";
 $class  = $client->call("getAphiaClassificationByID", array("AphiaID" => $AphiaID));
 echo "<b>Classification</b>: ";
 show_classification($class);

 function show_classification($class){
  echo $class["scientificname"]." (".$class["rank"].") > ";
  if ($class["child"]) show_classification($class["child"]);
 }

Step 3: Run the script

It should return something like this:
AphiaID: 127160
Displayname: Solea solea (Linnaeus, 1758)
URL: http://marinespecies.org/aphia.php?p=taxdetails&id=127160
Accepted name: Solea solea (Linnaeus, 1758)
Classification: Animalia (Kingdom) > Chordata (Phylum) > Vertebrata (Subphylum) > Gnathostomata (Superclass) > Pisces (Superclass) > Actinopterygii (Class) > Pleuronectiformes (Order) > Soleidae (Family) > Solea (Genus) > Solea solea (Species) >

Download this example.