Class GBIFSpeciesReader

java.lang.Object

org.episteme.natural.biology.loaders.GBIFSpeciesReader

public class GBIFSpeciesReader
extends Object

Loader for GBIF (Global Biodiversity Information Facility) Species API.

Fetches species occurrence and taxonomy data from GBIF.

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	GBIFSpeciesReader.SpeciesEntry	Represents a species entry from GBIF.

Constructor Summary

Constructors

Constructor	Description
GBIFSpeciesReader()

Method Summary

Modifier and Type	Method	Description
Optional<GBIFSpeciesReader.SpeciesEntry>	fetchByKey(long key)	Fetches species by GBIF key.
static String	getCategory()
List<GBIFSpeciesReader.SpeciesEntry>	getChildren(long parentKey, int limit)	Gets children of a taxon.
static String	getDescription()
Optional<String>	getSpeciesMedia(long speciesKey)	Gets the media (images) for a species.
List<GBIFSpeciesReader.SpeciesEntry>	searchByName(String name, int limit)	Searches for species by name.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

GBIFSpeciesReader

public GBIFSpeciesReader()

Method Details

getCategory

public static String getCategory()

getDescription

public static String getDescription()

fetchByKey

public Optional<GBIFSpeciesReader.SpeciesEntry> fetchByKey(long key)

Fetches species by GBIF key.

Parameters:

key - the GBIF species key

Returns:

the species entry, or empty if not found

searchByName

public List<GBIFSpeciesReader.SpeciesEntry> searchByName(String name,
 int limit)

Searches for species by name.

Parameters:

name - the species name to search

limit - maximum results

Returns:

list of matching species

getChildren

public List<GBIFSpeciesReader.SpeciesEntry> getChildren(long parentKey,
 int limit)

Gets children of a taxon.

getSpeciesMedia

public Optional<String> getSpeciesMedia(long speciesKey)

Gets the media (images) for a species.

Parameters:

speciesKey - the GBIF species key

Returns:

the first image URL found, or empty if not found