<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<p>Dear Markus,</p>
<p>Thank you very much. Do you have any idea, using the "suggest"
API would it be possible somehow to filter the results for the
Plantae kingdom only? <br>
</p>
József<br>
<br>
<br>
<div class="moz-cite-prefix">2017-09-07 10:17 keltezéssel, Markus
Döring írta:<br>
</div>
<blockquote type="cite"
cite="mid:1A043384-B6E6-4DB7-8FC8-798724A1DDEA@gbif.org">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
Hi József,
<div class=""><br class="">
</div>
<div class="">the GBIF API hardly anywhere accepts wildcards.
Apart from fuzzy matching entire words the only place you can
use is the suggest API which should help you with your problem.</div>
<div class=""><br class="">
</div>
<div class="">It is a kind of autocomplete and you have to match
the beginning of a word. It wont match in the middle or end. It
does match on all words or tokens of a string, so for a species
name it will match the genus part, the epithet or even the
authorship. Results are prioritized with author based matches
coming last and higher ranks being more important.</div>
<div class=""><br class="">
</div>
<div class="">Here is an example:</div>
<div class=""><a
href="http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado"
class="" moz-do-not-send="true">http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado</a></div>
<div class=""><br class="">
</div>
<div class="">The suggest API only allows you to retrieve 100
records though, but you can page through results up to 100.000
records max:</div>
<div class="">
<div class=""><a
href="http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado&limit=100"
class="" moz-do-not-send="true">http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado&limit=100</a></div>
</div>
<div class="">-> returns first 100 genera starting with Ado</div>
<div class="">
<div class=""><br class="">
</div>
<div class=""><a
href="http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado&limit=100&offset=100"
class="" moz-do-not-send="true">http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado&limit=100&offset=100</a></div>
</div>
<div class="">-> returns 49 more genera starting with Ado</div>
<div class="">
<div class=""><br class="">
</div>
<div class=""><a
href="http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado&limit=100&offset=200"
class="" moz-do-not-send="true">http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado&limit=100&offset=200</a></div>
<div class="">-> returns 0 genera as expected</div>
</div>
<div class=""><br class="">
</div>
<div class=""><br class="">
</div>
<div class="">Cheers,</div>
<div class="">Markus</div>
<div class=""><br class="">
</div>
<div class=""><br class="">
</div>
<div class=""><br class="">
<div>
<blockquote type="cite" class="">
<div class="">On 7. Sep 2017, at 08:36, Szlamka József <<a
href="mailto:szlajozs@gmail.com" class=""
moz-do-not-send="true">szlajozs@gmail.com</a>> wrote:</div>
<br class="Apple-interchange-newline">
<div class="">
<div bgcolor="#FFFFFF" text="#000000" class="">Dear Scott,<br
class="">
<br class="">
Many thanks for your answer. I also added the
"&highertaxonKey=6" param to narrow the results for
plant genera only.<br class="">
<br class="">
To be more precise what I exactly wish to achieve is as
follows:<br class="">
<br class="">
1./<br class="">
I only want to search within the "Plantae" kingdom.<br
class="">
<br class="">
2./<br class="">
Say, I look for the GENUS name "Adonis" but I only
remember that the name starts with "Ado".<br class="">
<br class="">
3./<br class="">
So my ideal API call would run a wildcard search within
PLANT GENERA names for "Ado*" and would result in a list
of ALL (without limit) plant genera names starting with
"Ado*".<br class="">
<br class="">
I played with the "/species/match", "/species/search"
and "/species/suggest" sub-apis and with the "q" and
"name" params. They don't accept wildcards and don't
give the expected results for name chunks without
wildcards.<br class="">
<br class="">
Now my only hope is that I left out some constellations
or misused something.<br class="">
<br class="">
József<br class="">
<br class="">
<br class="">
<div class="moz-cite-prefix">2017-09-06 23:21
keltezéssel, Scott Chamberlain írta:<br class="">
</div>
<blockquote type="cite"
cite="mid:CAD-oS=9JK4Kkz72qNJhSNdyTrO2-dqOWUya9WaHbeHC0ss+2iQ@mail.gmail.com"
class="">
<div dir="ltr" class="">Have you tried something like
<div class=""><br class="">
</div>
<div class=""><a
href="http://api.gbif.org/v1/species/search?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS"
moz-do-not-send="true" class="">http://api.gbif.org/v1/species/search?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS</a><br
class="">
</div>
<div class=""><br class="">
</div>
<div class="">where
datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c is
for the GBIF backbone taxonomy</div>
<div class=""><br class="">
</div>
<div class="">Scott</div>
</div>
<br class="">
<div class="gmail_quote">
<div dir="ltr" class="">On Wed, Sep 6, 2017 at 2:10
PM Szlamka József <<a
href="mailto:szlajozs@gmail.com"
moz-do-not-send="true" class="">szlajozs@gmail.com</a>>
wrote:<br class="">
</div>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">
Hello to all list members,<br class="">
<br class="">
I'm new on this list and also new to the GBIF API.
I'd like to get a<br class="">
list of all the genus names occuring in the GBIF
database. After several<br class="">
hours of trying with the API, and no success, I
found this mailing list.<br class="">
I hope that API guru members on the list can show
me the right way or<br class="">
tell if this is not possible at all.<br class="">
<br class="">
Thank you in advance.<br class="">
<br class="">
_______________________________________________<br
class="">
API-users mailing list<br class="">
<a href="mailto:API-users@lists.gbif.org"
target="_blank" moz-do-not-send="true" class="">API-users@lists.gbif.org</a><br
class="">
<a
href="https://lists.gbif.org/mailman/listinfo/api-users"
rel="noreferrer" target="_blank"
moz-do-not-send="true" class="">https://lists.gbif.org/mailman/listinfo/api-users</a><br
class="">
</blockquote>
</div>
</blockquote>
<br class="">
</div>
_______________________________________________<br
class="">
API-users mailing list<br class="">
<a href="mailto:API-users@lists.gbif.org" class=""
moz-do-not-send="true">API-users@lists.gbif.org</a><br
class="">
<a class="moz-txt-link-freetext" href="https://lists.gbif.org/mailman/listinfo/api-users">https://lists.gbif.org/mailman/listinfo/api-users</a><br
class="">
</div>
</blockquote>
</div>
<br class="">
</div>
</blockquote>
<br>
</body>
</html>