I try to implement a lazy-loading taxonomy tree (as a demo for a open source javascript tree plugin).
See here for an example: http://rawgit.com/mar10/fancytree/master/demo/taxonomy-browser/index.html#ke...
What JSON API should use to get the top level nodes (i.e. Kingdoms)? Currently I call http://api.gbif.org/v1/species/search?rank=kingdom http://api.gbif.org/v1/species/search?rank=kingdom but this returns much more than the ~7 entries I expect (Animalia, Plantae, Fungi, …)
I seem to get reasonable results, if I only display nodes with key == nubKey.
But the search results retrieved by `species/search?q=homo sapiens` returns multiple hits, and some of them have keys different from nubKey. Those matches seem to be descendants of an `Animals` kingdom that also has nubKey != key.
I guess my mental model of the data structure is too naïve: - why are there different ‚Animals‘ kingdoms with different keys but identical nubKey? - does it make sense at all to display a tree (with only one ‚animals‘ node)? - when I restrict the search results to entries that have a kingdom with key == nubKey, what will the user miss?
Thanks Martin Wendt
Hi Martin,
you should be using the species/root call from our species API: http://www.gbif.org/developer/species#nameUsages
It takes the datasetKey you are interested in, for example for the GBIF backbone taxonomy this call is: http://api.gbif.org/v1/species/root/d7dddbf4-2cf0-4f39-9b2a-bb099caae36c
Subsequent, pageable childs are then retrieved with: http://api.gbif.org/v1/species/1/children
The search you have been doing is across all checklist datasets we have indexed so you get kingdoms from hundreds of different taxonomies.
best, Markus
-- Markus Döring Software Developer Global Biodiversity Information Facility (GBIF) mdoering@gbif.orgmailto:mdoering@gbif.org http://www.gbif.org
On 19 Dec 2015, at 14:26, Martin Wendt <gbif@wwwendt.demailto:gbif@wwwendt.de> wrote:
I try to implement a lazy-loading taxonomy tree (as a demo for a open source javascript tree plugin).
See here for an example: http://rawgit.com/mar10/fancytree/master/demo/taxonomy-browser/index.html#ke...
What JSON API should use to get the top level nodes (i.e. Kingdoms)? Currently I call http://api.gbif.org/v1/species/search?rank=kingdom but this returns much more than the ~7 entries I expect (Animalia, Plantae, Fungi, …)
I seem to get reasonable results, if I only display nodes with key == nubKey.
But the search results retrieved by `species/search?q=homo sapiens` returns multiple hits, and some of them have keys different from nubKey. Those matches seem to be descendants of an `Animals` kingdom that also has nubKey != key.
I guess my mental model of the data structure is too naïve: - why are there different ‚Animals‘ kingdoms with different keys but identical nubKey? - does it make sense at all to display a tree (with only one ‚animals‘ node)? - when I restrict the search results to entries that have a kingdom with key == nubKey, what will the user miss?
Thanks Martin Wendt _______________________________________________ API-users mailing list API-users@lists.gbif.orgmailto:API-users@lists.gbif.org http://lists.gbif.org/mailman/listinfo/api-users
participants (2)
-
Markus Döring -
Martin Wendt