<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Hi,<div class=""><br class=""></div><div class="">the taxonKey <a href="http://api.gbif.org/v1/species/6092438" style="widows: 1;" class="">6092438</a> represents the subspecies <span style="color: rgb(0, 128, 0); font-family: monospace; font-size: medium; widows: 1;" class="">Corvus monedula subsp. soemmerringii</span></div><div class=""><div style="widows: 1;" class=""><a href="http://api.gbif.org/v1/species/6092438" class="">http://api.gbif.org/v1/species/6092438</a></div><div style="widows: 1;" class=""><br class=""></div><div style="widows: 1;" class="">For that subspecies we are lacking a vernacular name. As you have seen we have the vernacular name just for the species. It might be applicable for the subspecies in your case, but we do not retrieve that automatically.</div><div style="widows: 1;" class="">The taxonKey can represent any backbone taxon of any rank up to kingom and down to forma. And as you have seen not all taxa do have a common name.</div><div style="widows: 1;" class=""><br class=""></div><div style="widows: 1;" class="">Markus</div><div style="widows: 1;" class=""><br class=""></div><div style="widows: 1;" class=""><br class=""></div><div><blockquote type="cite" class=""><div class="">On 28 Apr 2015, at 16:48, Priyank Tiwari <<a href="mailto:priyankgt@gmail.com" class="">priyankgt@gmail.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div dir="ltr" class=""><div class="">Thanks Markus.</div><div class=""><br class=""></div><div class="">Let me take a quick example from the downloaded occurrences.txt </div><div class=""><br class=""></div><div class="">The occurrence record has gbifid = 1056676532, taxonKey = 6092438 and speciesKey = 2482473.</div><div class="">If we use <a href="http://api.gbif.org/v1/species/%7Bint%7D/vernacularNames" target="_blank" class="">http://api.gbif.org/v1/species/{int}/vernacularNames</a> API with taxonKey = 6092438, then it gives 0 results (<a href="http://api.gbif.org/v1/species/6092438/vernacularNames" class="">http://api.gbif.org/v1/species/6092438/vernacularNames</a>), where as if we use speciesKey in the API, it gives proper results as I would like to display (<a href="http://api.gbif.org/v1/species/2482473/vernacularNames" class="">http://api.gbif.org/v1/species/2482473/vernacularNames</a>).</div><div class=""><br class=""></div><div class="">Will taxonKey be unique for every species or does it map to higher order species in the classification hierarchy?<br class=""></div><div class=""><br class=""></div>
<div class=""><br class=""></div></div><div class="gmail_extra"><br class=""><div class="gmail_quote">On Tue, Apr 28, 2015 at 7:10 PM, Markus Döring <span dir="ltr" class=""><<a href="mailto:mdoering@gbif.org" target="_blank" class="">mdoering@gbif.org</a>></span> wrote:<br class=""><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style="word-wrap:break-word" class="">Hi Priyank,<div class=""><br class=""><div class=""><div class=""><span class=""><blockquote type="cite" class=""><div class="">1. What should be my primary key for species table? I see 'speciesKey' column as a candidate, but it is set as null for some species. The occurrence record has a scientific name but no speciesKey. Any suggestions on this? What field I can use as unique identifier for species?</div></blockquote></span>taxonKey is the primary key, speciesKey points to the accepted species but your occurrence might be linked to a subspecies or even a synonym name</div><div class=""><span class=""><br class=""><blockquote type="cite" class=""><div dir="ltr" class=""><div class="">2. Vernacular names are missing for almost all the occurrences. Is there any API by which I can also obtain vernacular names for a species? <a href="http://api.gbif.org/v1/species/%7Bint%7D/vernacularNames" target="_blank" class="">http://api.gbif.org/v1/species/{int}/vernacularNames</a> seems to do the job, but what is {int} (speciesKey?) and how do I get it from occurrence data?</div></div></blockquote></span>As you said use the species API to get vernacular names. {int} is the taxonKey from the occurrence record. 212, birds in this case:<br class=""><a href="http://api.gbif.org/v1/species/212/vernacularNames" target="_blank" class="">http://api.gbif.org/v1/species/212/vernacularNames</a></div><div class=""><br class=""></div><div class=""><span class=""><br class=""><blockquote type="cite" class=""><div dir="ltr" class=""><div class="">3. I also need few representative images of the species. <a href="http://api.gbif.org/v1/species/%7Bint%7D/media" target="_blank" class="">http://api.gbif.org/v1/species/{int}/media</a> seems to do the job, but it returns a large image and I am looking for a small thumbnail image. Any way to accomplish this? Also, any API that can provide me both the vernacular names and imge url in single API call?</div></div></blockquote></span><div class="">I am afraid that does not exist. We use an image cache internally that produces thumbnails, but its not part of the public API.</div><div class="">We also do not have flagged just one image as the representative. And watch out for the media type, it can also be videos or sounds.</div><div class=""><br class=""></div><div class="">cheers,</div><div class="">Markus</div><div class=""><br class=""></div><blockquote type="cite" class=""><div dir="ltr" class=""><div class=""><br class=""></div><div class="">Thanks,</div><div class="">Priyank</div>
</div>
_______________________________________________<br class="">API-users mailing list<br class=""><a href="mailto:API-users@lists.gbif.org" target="_blank" class="">API-users@lists.gbif.org</a><br class=""><a href="http://lists.gbif.org/mailman/listinfo/api-users" target="_blank" class="">http://lists.gbif.org/mailman/listinfo/api-users</a><br class=""></blockquote></div><br class=""></div></div></div></blockquote></div><br class=""><br clear="all" class=""><div class=""><br class=""></div>-- <br class=""><div class="gmail_signature">~ Priyank</div>
</div>
</div></blockquote></div><br class=""></div></body></html>