You are here: Web API Functions > getthumb

getthumb

The getthumb command gets a thumbnail image of an item hosted by the Express Server.

Syntax

The getthumb command can be invoked in several ways.

The following returns a thumbnail from the specified item:

getthumb?cat=<catalog-name>&item=<item-id>

The following returns a thumbnail from the specified item using the specified thumbspec:

getthumb?cat=<catalog-name>&item=<item-id>&thumbspec=<thumbspec-name>

Parameters

The following parameters may be used with the getthumb command:

cat

The catalog name.

item

The ID of the item. The itemid is the folder path to the item plus the item name (or iserv-catalog-index, which specifies the spatial index).

thumbspec

Specifies which thumbspec to use. Thumbspecs are defined in the catalog configuration file. They specify the extraction parameters to use when generating a thumbspec.

Examples

The following examples are "live" in that they contain real URLs that will access an Express Server. Change the hostname to your host to see your own server's responses to these queries.

The following gets a thumbnail for the specified item:

http://demo.lizardtech.com/lizardtech/iserv/getthumb?cat=Geo&item=Seattle_toposkin_DEM.sid

The following gets a small thumbnail for the specified item:

http://demo.lizardtech.com/lizardtech/iserv/getthumb?cat=Geo&item=Seattle_toposkin_DEM.sid&thumbspec=small

The following is the same query as the one above but expressed in the hierarchical query format:

http://demo.lizardtech.com/lizardtech/iserv/catalogs/Geo/Seattle_toposkin_DEM.sid/cmd/getthumb/thumbspec/small