PBDB Data Service 1.2 v1 > Taxonomic names > Icon images of lifeforms

DESCRIPTION

This operation returns an image to represent the specified taxon, or else information about the image. If the suffix is .png, then the image content data is returned. Otherwise, a descriptive record is returned in the specified format.

These 32x32 icon (blue silhouette) images are sourced from http://phylopic.org/. If multiple images are available for a particular taxon, one has been arbitrarily selected. You can obtain image identifiers by including show=img with any taxonomic name query.

USAGE

Here are some usage examples:

PARAMETERS

id

Return the image corresponding to the specified image identifier, or information about the image.

taxon_id

Return the image corresponding to the specified taxon, or information about the image.

taxon_name

Return the image corresponding to the specified taxonomic name, or information about the image. If more than one name matches the parameter value, the one with the largest number of occurrences in the database will be used. You can also use the parameter alias name. You may not specify both taxon_name and taxon_id in the same query.

save

Specifies the name of a local file to which the output of this request should be saved. Whether and how this happens depends upon which web browser you are using. You can specify save=no instead if you wish to display the result in the browser If you include this parameter without any value, a default filename will be provided.

You can also use any of the special parameters with this request.

METHODS

This data service accepts the following HTTP methods: GET, HEAD

RESPONSE

The response to an HTTP request with this operation will consist of fields from the following list.

Field nameBlockDescription
pbdbcom
image_no oid basic

A unique identifier for this image, generated locally by this database

record_type typ basic

The type of this record: 'img' for an image

taxon_no tid basic

The identifier of the taxon with which this image is associated. This field will only appear in results generated by taxa/list_images.

taxon_name tna basic

The taxonomic name with which this image is associated. This field will only appear in results generated by taxa/list_images.

uid uid basic

A unique identifier for this image generated by phylopic.org

modified dmd basic

The date and time at which this image was last modified on phylopic.org

credit crd basic

The name to which this image should be credited if used

license lic basic

A URL giving the license terms under which this image may be used

FORMATS

The following response formats are available for this operation. You must select the desired format for a request by adding the appropriate suffix to the URI path.

FormatSuffixDocumentation
JSON .json

JSON format

Comma-separated text .txt

Text formats

Comma-separated text .csv

Text formats

Tab-separated text .tsv

Text formats

PNG .png

PNG format

VOCABULARIES

The following response vocabularies are available for this operation. If you wish your responses to be expressed in a vocabulary other than the default for your selected format, you can use the vocab parameter with the appropriate vocabulary name.

VocabularyNameDefault forDescription
PaleobioDB field names pbdb txt, csv, tsv

The PBDB vocabulary is derived from the underlying field names and values in the database, augmented by a few new fields. For the most part any response that uses this vocabulary will be directly comparable to downloads from the PBDB Classic interface. This vocabulary is the default for text format responses.

Compact field names com json

The Compact vocabulary is a set of 3-character field names designed to minimize the size of the response message. This is the default for JSON format responses. Some of the field values are similarly abbreviated, while others are conveyed in their entirety. For details, see the documentation for the individual response fields.

 

This service is provided by the Paleobiology Database, hosted by the Department of Geoscience at the University of Wisconsin-Madison.

If you have questions about this data service, or wish to report a bug, please contact the database administrator at admin@paleobiodb.org