Multimedia data services

Digitisation of the specimens in our collection includes a detailed photographic documentation. So far, there are more than 5 million photos stored in the Naturalis MediaLib. NBA’s multimedia data services provide an interface to the MediaLib for the public. Since each multimedia record has to be associated with a specimen or taxon which in turn has to have an identification, this dataset has great potential to be used in automatic image recognition applications. Furthermore, the MediaLib features videos and also artistic drawings of animals and plants.

Base URL

The base URL for multimedia-specific services is http://api.biodiversitydata.nl/v2/multimedia

Data Source Systems

Most multimedia data are retrieved from our in-house registration systems for botanical (BRAHMS) or zoological/geological (CRS) specimens, and most are plant photos. A small fraction items is retrieved from the Dutch Species Register. As for the other data types, the source system can be retrieved by querying the fields sourceSystem.code and sourceSystem.name.

Available services

Query

Querying for multimedia data can be done using the /multimedia/query/ endpoint , which accepts human-readable query strings and JSON encoded QuerySpec parameters.

Data access

Several access methods offer the convenient retrieval of multimedia records matching a certain identifier. The services /multimedia/find/ and /multimedia/findByIds/ retrieve taxa according to their id fields (see here).

Metadata

Metadata services provide miscellaneous information about multimedia records. This includes detailed information about all fields and paths . A description of all multimedia metadata services can be found here .

Identifiers

The field sourceSystemId of a geo area is the identifier as it is in the source database. The surceSystemId, in turn, consists of the specimen unitID for which media was recorded, and an internal identifier(for example RMNH.AVES.140023_2). A unique identifier consisting of {sourceSystemId}@{sourceSystem.code} is stored in the field id, e.g. RMNH.AVES.140023_2@CRS.

Each multimedia record is linked either to the id of a specimen or a taxon via the fields associatedSpecimenReference and associatedTaxonReference, respectively. In order to provide a faster search for specific specimen/taxon attributes within multimedia content, their identifications block is included in a multimedia record. For example, one can search for the pygmy cormorant, given its species name Phalacrocorax pygmeus:

http://api.biodiversitydata.nl/v2/multimedia/query/?identifications.defaultClassification.genus=Phalacrocorax&identifications.defaultClassification.specificEpithet=pygmeus

Downloading multimedia content

Each multimedia record has one or more download URLs retrievable via the field(s) serviceAccessPoints.accessURI. Below we query for the image location of the pygmy cormorant:

http://api.biodiversitydata.nl/v2/<p>multimedia/query/?identifications.defaultClassification.genus=Phalacrocorax&identifications. defaultClassification.specificEpithet=pygmeus&_fields=serviceAccessPoints.accessUri</p>

pigmy-cormorant

Museum specimen of the Pygmy cormorant (Phalacrocorax pygmeus)

Artistic images

Next to photos and videos of specimens, the NBA also gives access to about 2500 artistic scientific drawings and lithographs. These documents are categorised in the collection Arts and can be retrieved via the field collectionType. To obtain all drawings picturing species of genus Phalacrocorax, one can query within the Arts collection:

http://api.biodiversitydata.nl/v2/multimedia/query/?identifications.defaultClassification.genus=Phalacrocorax&collectionType=Arts

Among the results we find for instance this nice drawing of Phalacrocorax aristotoles:

shag-drawing

Drawing of the European shag (Phalacrocorax aristotoles)

Licensing

Each multimedia item is published under a copyright license. Licenses can be accessed by the fields licenseType and license. Most of them are published under one of the Creative Commons licenses.