<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman",serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.apple-tab-span
{mso-style-name:apple-tab-span;}
span.apple-converted-space
{mso-style-name:apple-converted-space;}
span.EmailStyle20
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;}
@page WordSection1
{size:8.5in 11.0in;
margin:70.85pt 70.85pt 56.7pt 70.85pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Dear Anton and colleagues<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Might it be possible to pick this issue regarding the taxonomic backbone up, since this concerns EU-BON? I think this is an important issue to assure that GBIF/EU-BON’s
names are mapped.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Cheers<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Donat<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></p>
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif">From:</span></b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif"> API-users [mailto:api-users-bounces@lists.gbif.org]
<b>On Behalf Of </b>Roderic Page<br>
<b>Sent:</b> Monday, January 26, 2015 11:13 AM<br>
<b>To:</b> Tim Robertson; Antonio García Camacho; info@eu-nomen.eu<br>
<b>Cc:</b> api-users@lists.gbif.org<br>
<b>Subject:</b> Re: [API-users] API GBIF: search species using GUID (LSID)<o:p></o:p></span></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Just to follow up on Tim’s response, as far as I can tell from the EU BON taxonomic backbone, the LSID referred to is provided by PESI (e.g., urn:lsid:faunaeur.org:taxname:115091) and - like many LSIDs - sadly doesn’t actually work (in
the sense that it can’t be resolved), see e.g. <a href="http://darwin.zoology.gla.ac.uk/~rpage/lsid/tester/?q=urn%3Alsid%3Afaunaeur.org%3Ataxname%3A115091">http://darwin.zoology.gla.ac.uk/~rpage/lsid/tester/?q=urn%3Alsid%3Afaunaeur.org%3Ataxname%3A115091</a>
<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">The PESI web site links names to GBIF, so PESI has a mapping between their LSIDs and GBIF. One way to go from a PESI LSID to GBIF would be if PESI provided that mapping in their web services <a href="http://www.eu-nomen.eu/portal/webservices.php">http://www.eu-nomen.eu/portal/webservices.php</a> It’s
not clear to me that they do this.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Alternatively, Fauna Europaea has been indexed by GBIF (more than once!), so you could use the GBIF API like this:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">1. Given a LSID like urn:lsid:faunaeur.org:taxname:115091, trim off the “urn:lsid:faunaeur.org:taxname:” to leave “115091”<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">2. Call the GBIF API with 115091 as the sourceId key, and datasetKey as 90d9e8a6-0ce1-472d-b682-3451095dbc5a (this is the Fauna Europaea dataset that seems to match the PESI ids <a href="http://www.gbif.org/dataset/90d9e8a6-0ce1-472d-b682-3451095dbc5a">http://www.gbif.org/dataset/90d9e8a6-0ce1-472d-b682-3451095dbc5a</a> ).<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">The URL is:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal"><a href="http://api.gbif.org/v1/species?sourceId=115091&datasetKey=90d9e8a6-0ce1-472d-b682-3451095dbc5a">http://api.gbif.org/v1/species?sourceId=115091&datasetKey=90d9e8a6-0ce1-472d-b682-3451095dbc5a</a><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">This will give you<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">{"offset":0,"limit":20,"endOfRecords":true,"results":[{"key":103283278,"nubKey":1097026,"taxonID":"115091","genus":"Prionus","genusKey":103283278,"datasetKey":"90d9e8a6-0ce1-472d-b682-3451095dbc5a","parentKey":103294043,"parent":"Prioninae","scientificName":"Prionus
Geoffroy, 1762","canonicalName":"Prionus","authorship":"Geoffroy, 1762","nameType":"WELLFORMED","rank":"GENUS","origin":"SOURCE","taxonomicStatus":"ACCEPTED","nomenclaturalStatus":[],"numDescendants":6,"references":"<a href="http://www.faunaeur.org/full_results.php?id=115091">http://www.faunaeur.org/full_results.php?id=115091</a>","modified":"2014-06-14T21:04:19.241+0000","lastInterpreted":"2014-11-03T15:22:26.302+0000","issues":[],"synonym":false}]}<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">The “nubKey” field has the value 1097026, which is the identifier for GBIF’s classification <a href="http://www.gbif.org/species/1097026">http://www.gbif.org/species/1097026</a> You can use 1097026 as the key in a query to get the distribution
using the GBIF API.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Regards<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Rod<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<p class="MsoNormal"><span style="color:black">---------------------------------------------------------<br>
Roderic Page<br>
Professor of Taxonomy<br>
Institute of Biodiversity, Animal Health and Comparative Medicine<br>
College of Medical, Veterinary and Life Sciences<br>
Graham Kerr Building<br>
University of Glasgow<br>
Glasgow G12 8QQ, UK<br>
<br>
Email: <span class="apple-tab-span"> </span><a href="mailto:Roderic.Page@glasgow.ac.uk">Roderic.Page@glasgow.ac.uk</a><br>
Tel: <span class="apple-tab-span"> </span>+44 141 330 4778<br>
Skype: <span class="apple-tab-span"> </span>rdmpage<br>
Facebook: <span class="apple-tab-span"> </span><a href="http://www.facebook.com/rdmpage">http://www.facebook.com/rdmpage</a><br>
LinkedIn: <span class="apple-tab-span"> </span><a href="http://uk.linkedin.com/in/rdmpage">http://uk.linkedin.com/in/rdmpage</a><br>
Twitter: <span class="apple-tab-span"> </span><a href="http://twitter.com/rdmpage">http://twitter.com/rdmpage</a><br>
Blog: <span class="apple-tab-span"> </span><a href="http://iphylo.blogspot.com">http://iphylo.blogspot.com</a><br>
ORCID: <span class="apple-tab-span"> </span><a href="http://orcid.org/0000-0002-7101-9767">http://orcid.org/0000-0002-7101-9767</a><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:black">Citations: <span class="apple-tab-span">
</span><a href="http://scholar.google.co.uk/citations?hl=en&user=4Z5WABAAAAAJ">http://scholar.google.co.uk/citations?hl=en&user=4Z5WABAAAAAJ</a><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt"><span style="color:black">ResearchGate<span class="apple-tab-span">
</span><a href="https://www.researchgate.net/profile/Roderic_Page">https://www.researchgate.net/profile/Roderic_Page</a><o:p></o:p></span></p>
</div>
</div>
</div>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<blockquote style="margin-top:5.0pt;margin-bottom:5.0pt">
<div>
<p class="MsoNormal">On 26 Jan 2015, at 08:48, Tim Robertson <<a href="mailto:trobertson@gbif.org">trobertson@gbif.org</a>> wrote:<o:p></o:p></p>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<div>
<div>
<p class="MsoNormal">Hola Antonio<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Can you please join and use the GBIF API mailing list for questions relating to the API?<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <a href="http://lists.gbif.org/mailman/listinfo/api-users">http://lists.gbif.org/mailman/listinfo/api-users</a><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">We don’t make explicit use of LSIDs on <a href="http://gbif.org/">
GBIF.org</a>. I expect what you want to do is lookup the GBIF species key using the species API, and then use that on the occurrence API to get occurrences.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">E.g. Given the plant genus <i>Oenanthe </i> you can look up the taxon (name usage) information using:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <a href="http://api.gbif.org/v1/species/match?verbose=false&kingdom=Plantae&name=Oenante">http://api.gbif.org/v1/species/match?verbose=false&kingdom=Plantae&name=Oenante</a><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">noting the usageID is 3034893 in the response. You’d presumably either do this on demand or map this to your own backbone periodically. This can then be used to search for occurrences:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <a href="http://api.gbif.org/v1/occurrence/search?taxonKey=3034893">http://api.gbif.org/v1/occurrence/search?taxonKey=3034893</a><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Alternatively, if you were to publish your own checklist and have GBIF index it, the taxa would be searchable using your own sourceId:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <a href="http://api.gbif.org/v1/species?sourceId=%3Cyour%20id%20here%3E">http://api.gbif.org/v1/species?sourceId=<your id here></a> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">I hope this helps,<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">Tim<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<div>
<p class="MsoNormal">On 26 Jan 2015, at 09:35, Éamonn Ó Tuama [GBIF] <<a href="mailto:eotuama@gbif.org">eotuama@gbif.org</a>> wrote:<o:p></o:p></p>
</div>
<p class="MsoNormal"><br>
<br>
<o:p></o:p></p>
<blockquote style="margin-top:5.0pt;margin-bottom:5.0pt">
<div>
<div>
<p class="MsoNormal"><span lang="EN-GB" style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Tim,</span><span lang="EN-GB"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-GB" style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Best for you to answer Antonio.</span><span lang="EN-GB"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-GB" style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Éamonn</span><span lang="EN-GB"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-GB" style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"> </span><span lang="EN-GB"><o:p></o:p></span></p>
</div>
<div>
<div style="border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0in 0in 0in">
<div>
<p class="MsoNormal"><b><span style="font-size:10.0pt;font-family:"Tahoma",sans-serif">From:</span></b><span class="apple-converted-space"><span style="font-size:10.0pt;font-family:"Tahoma",sans-serif"> </span></span><span style="font-size:10.0pt;font-family:"Tahoma",sans-serif">Antonio
García Camacho [<a href="mailto:antonio.garcia.camacho@csic.es"><span style="color:purple">mailto:antonio.garcia.camacho@csic.es</span></a>]<span class="apple-converted-space"> </span><br>
<b>Sent:</b><span class="apple-converted-space"> </span>26 January 2015 01:42<br>
<b>To:</b><span class="apple-converted-space"> </span>Éamonn Ó Tuama<br>
<b>Subject:</b><span class="apple-converted-space"> </span>API GBIF: search species using GUID (LSID)</span><span lang="EN-GB"><o:p></o:p></span></p>
</div>
</div>
</div>
<div>
<p class="MsoNormal"><span lang="EN-GB"> <o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-GB">Dear Éamonn,<o:p></o:p></span></p>
</div>
<div>
<div>
<p class="MsoNormal"><span lang="EN-GB">We found some problems using the GBIF API to search for occurrences and datasets. I will explain the use scenario:<o:p></o:p></span></p>
</div>
</div>
<div>
<div>
<p class="MsoNormal"><span lang="EN-GB">Using the EU BON taxonomic backbone we will find out the LSID of a given species. Therefore, we want to use this LSID, a universal identifier actually, to ask for datasets and occurrences to each data provider. Using
GBIF occurrence API we can search filtering by scientific name or even by taxonKey, but it seems that we can not filter using the LSID.<o:p></o:p></span></p>
</div>
</div>
<div>
<div>
<p class="MsoNormal"><span lang="EN-GB">Is there a way to filter using species LSIDs or even translating these LSIDs to taxonKeys?<o:p></o:p></span></p>
</div>
</div>
<div>
<div>
<p class="MsoNormal"><span lang="EN-GB"> <o:p></o:p></span></p>
</div>
</div>
<div>
<div>
<p class="MsoNormal"><span lang="EN-GB">Thanks,<o:p></o:p></span></p>
</div>
</div>
<div>
<div>
<p class="MsoNormal"><span lang="EN-GB">Antonio.<o:p></o:p></span></p>
</div>
</div>
<div>
<div>
<p class="MsoNormal"><span lang="EN-GB"> <o:p></o:p></span></p>
</div>
<div>
<div>
<p class="MsoNormal"><span lang="EN-GB"> <o:p></o:p></span></p>
</div>
</div>
<div>
<div>
<p class="MsoNormal"><span lang="EN-GB" style="background:white">-- </span><span lang="EN-GB"><o:p></o:p></span></p>
</div>
<div>
<div>
<p class="MsoNormal"><strong><span lang="EN-GB">Antonio García Camacho</span></strong><span lang="EN-GB"><br>
Estacion Biologica de Doñana (CSIC)<br>
Americo Vespucio s/n Isla de la Cartuja<br>
41092 Sevilla, España<br>
Tel. +34 954232340 / Fax. +34 954621125<br>
<a href="mailto:antonio.garcia.camacho@csic.es"><span style="color:purple">antonio.garcia.camacho@csic.es</span></a><br>
<a href="http://www.ebd.csic.es/"><span style="color:purple">www.ebd.csic.es</span></a><o:p></o:p></span></p>
</div>
</div>
</div>
</div>
</div>
</blockquote>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal">_______________________________________________<br>
API-users mailing list<br>
<a href="mailto:API-users@lists.gbif.org">API-users@lists.gbif.org</a><br>
<a href="http://lists.gbif.org/mailman/listinfo/api-users">http://lists.gbif.org/mailman/listinfo/api-users</a><o:p></o:p></p>
</div>
</blockquote>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</div>
</div>
</body>
</html>