<html><head><meta http-equiv="Content-Type" content="text/html charset=windows-1252"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">Hi Daniele,<div><br></div><div>1) the possible match type values can be found as a java enumeration inside the NameUsageMatch class:</div><div><a href="http://gbif.github.io/gbif-api/apidocs/org/gbif/api/model/checklistbank/NameUsageMatch.MatchType.html">http://gbif.github.io/gbif-api/apidocs/org/gbif/api/model/checklistbank/NameUsageMatch.MatchType.html</a></div><div><br></div><div>2) Name matching is only working against the GBIF backbone dataset. It will never return any other dataset.&nbsp;</div><div>If you use the verbatim=true parameter close alternatives are returned. This is regardless of the type of match.</div><div><br></div><div>3) Any name should be URL encoded when given as a query parameter. This is the standard way how values are encoded for HTTP GET parameters.</div><div>All programming languages provide a way to encode your string in such a way, but if you do manual calls you can use online encoding service like this one here:</div><div><a href="http://meyerweb.com/eric/tools/dencoder/">http://meyerweb.com/eric/tools/dencoder/</a></div><div><br></div><div>For example the fake name "Abies Mûtlï &amp; Döring” would be encoded like this:</div><div><a href="http://api.gbif.org/v1/species/match?verbose=true&amp;kingdom=Plantae&amp;name=">http://api.gbif.org/v1/species/match?verbose=true&amp;kingdom=Plantae&amp;name=</a>Abies%20M%C3%BBtl%C3%AF%20%26%20D%C3%B6ring</div><div><br></div><div><br></div><div>with regards,</div><div>Markus</div><div><br><div><div>On 10 Oct 2014, at 20:08, Daniele Palazzi &lt;<a href="mailto:danicpalazzi@gmail.com">danicpalazzi@gmail.com</a>&gt; wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div dir="ltr"><div><div>Hello,</div><div><br></div><div>&nbsp; I'm development a tool for data quality and I'm using the GBIF API to validate scientific names.</div><div>&nbsp; I want to know if you have a documentation about the JSON response. I have any questions:</div><div>&nbsp; 1- What the possibles values to matchType attribute?&nbsp;</div><div>&nbsp; 2- When the result is exact, always return a single dataset? And when the result isn't exact, the &nbsp;attribute "alternatives" &nbsp;return the datasets that better matche with the search term?</div><div>&nbsp; 3- What kind of URL I should use when the name query has space and special caracteres, for example, ().,&amp; ?</div><div>&nbsp;</div><div>&nbsp; Thank you,</div></div><div><br></div>-- <br><div dir="ltr"><div style="color: rgb(80, 0, 80); font-family: Calibri, 'Segoe UI', Meiryo, 'Microsoft YaHei UI', 'Microsoft JhengHei UI', 'Malgun Gothic', 'Khmer UI', 'Nirmala UI', Tunga, 'Lao UI', Ebrima, sans-serif; font-size: 16px;"><br class="webkit-block-placeholder"></div><p style="color:rgb(34,34,34);font-family:arial;font-size:small"><span lang="PT-BR" style="color:rgb(31,73,125)">&nbsp;<u></u></span></p><table border="0" cellspacing="0" cellpadding="0" style="color:rgb(34,34,34);font-family:arial;font-size:small;border-collapse:collapse;border:none"><tbody><tr><td width="177" valign="top" style="width:133pt;border-style:none solid none none;border-right-color:rgb(79,98,40);border-right-width:1.5pt;padding:0in 5.4pt"><p><span>&lt;image005.jpg&gt;</span><span lang="PT-BR"><u></u><u></u></span></p></td><td width="399" valign="top" style="width:299.2pt;border:none;padding:0in 5.4pt"><p><b><span lang="PT-BR" style="font-size:10pt;color:rgb(54,95,145)">Daniele Palazzi Krempser<u></u><u></u></span></b></p><p><b><i><span lang="PT-BR" style="font-size:10pt;color:rgb(54,95,145)">Especialista em Banco de Dados<u></u></span></i></b></p><p><span lang="PT-BR" style="font-size:10pt;color:rgb(31,73,125)">Laboratório Nacional da Computação Científica</span><b><i><span lang="PT-BR" style="font-size:10pt;color:rgb(54,95,145)"><u></u><u></u></span></i></b></p><p><span lang="PT-BR" style="font-size:10pt;color:rgb(54,95,145)"><a href="tel:%2B55%2024%20%C2%A02233-6183" value="+552422336183" target="_blank">+55 24 &nbsp;2233-6183</a><br></span></p><p><span lang="PT-BR" style="font-size:10pt;color:rgb(54,95,145)"><a href="tel:%2B55%2024%2098822-4495" value="+5524988224495" target="_blank">+55 24 98822-4495</a><u></u></span></p><p><span lang="PT-BR" style="font-size:10pt;color:rgb(54,95,145)">Skype: danicpalazzi<u></u><u></u></span></p><p><span lang="PT-BR" style="font-size:10pt;color:rgb(31,73,125)"><a href="mailto:dpalazzi@lncc.br" target="_blank">dpalazzi@lncc.br</a></span><span lang="PT-BR" style="font-size:10pt;color:rgb(54,95,145)"><u></u><u></u></span></p><p><span lang="PT-BR"><a href="http://www.sibbr.gov.br/" style="color:rgb(17,85,204)" target="_blank"><span style="font-size:10pt;color:rgb(31,73,125);text-decoration:none">www.sibbr.gov.br</span></a></span><span lang="PT-BR" style="font-size:10pt;color:rgb(31,73,125)"><u></u><u></u></span></p></td></tr></tbody></table><p style="color:rgb(34,34,34);font-family:arial;font-size:small"><span lang="PT-BR" style="color:rgb(31,73,125)"><u></u>&nbsp;</span></p><div><br class="webkit-block-placeholder"></div></div>
</div>
_______________________________________________<br>API-users mailing list<br><a href="mailto:API-users@lists.gbif.org">API-users@lists.gbif.org</a><br>http://lists.gbif.org/mailman/listinfo/api-users<br></blockquote></div><br></div></body></html>