Skip to content

Multimedia Data Services

Naturalis stores a vast amount of multimedia in its internal document store. This can be multimedia captured from physical specimens (e.g. photos of a specimen), but also from human observations (e.g. audio recordings of bird sounds). Digitisation of Naturalis museum objects include a detailed photographic documentation. So far, there are more than 13 million photos and several hundreds of thousands of bird sounds.

Base URL

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

Data Source Systems

Multimedia data are retrieved from our in-house registration systems for botanical (BRAHMS) or zoological/geological (CRS) specimens, and from our external partner Observation International. In 2018, we added the records from Xeno-canto, the most comprehensive database of bird sounds to date. A small fraction of items is retrieved from both the Dutch Species Register, and the Dutch Caribbean Species Register.

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 sourceSystemId, 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:

https://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:

https://api.biodiversitydata.nl/v2/multimedia/query/?identifications.defaultClassification.genus=Phalacrocorax&identifications.defaultClassification.specificEpithet=pygmeus&\_fields=serviceAccessPoints.accessUri

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:

https://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

License details for each multimedia item can be accessed by the fields licenseType and license. Most of them are published under one of the Creative Commons licenses.

Back to top