v39

latestOpenAPI 3.0.3raw.githubusercontent.com2026-06-18118982.1 KB

Data

Fetch a single collection asset

Fetch the collection asset with id assetId of the collection with id collectionId.

get/collections/{collectionId}/assets/{assetId}

Path parameters

collectionIdstring required

Local identifier of a collection

assetIdstring required

Local identifier of an asset.

Headers

If-Matchstring

The RFC7232 If-Match header field makes the GET request method conditional. It is composed of a comma separated list of ETags or value "*".

The server compares the client's ETags (sent with If-Match) with the ETag for its current version of the resource, and if both values don't match (that is, the resource has changed), the server sends back a 412 Precondition Failed status, without a body, which tells the client that the cached version of the response is not good to use anymore.

If-None-Matchstring

The RFC7232 If-None-Match header field makes the GET request method conditional. It is composed of a comma separated list of ETags or value "*".

The server compares the client's ETags (sent with If-None-Match) with the ETag for its current version of the resource, and if both values match (that is, the resource has not changed), the server sends back a 304 Not Modified status, without a body, which tells the client that the cached version of the response is still good to use (fresh).

Response

The response is a document consisting of one asset of the collection.

idstring required

The asset id uniquely identifies the asset for an item

Note: id must be unique for the item and must be identical to the filename.

typestring required

Media type of the asset

titlestring

Displayed title

descriptionstring

Detailed multi-line description to fully explain the catalog or collection.

CommonMark 0.29 syntax MAY be used for rich text representation.

hrefstring url

Link to the asset object.

Details about asset object calls, specifically information about caching behavior can be found here

file:checksumstring

sha2-256 checksum of the asset in multihash format.

rolesstring[]

Purposes of the asset

geoadmin:variantstring

geoadmin:lang'de' | 'it' | 'fr' | 'rm' | 'en'

proj:epsginteger

A Coordinate Reference System (CRS) is the data reference system (sometimes called a 'projection') used by the asset data, and can usually be referenced using an EPSG code. If the asset data does not have a CRS, such as in the case of non-rectified imagery with Ground Control Points, proj:epsg should be set to null. It should also be set to null if a CRS exists, but for which there is no valid EPSG code.

gsdnumber

GSD is the nominal Ground Sample Distance for the data, as measured in meters on the ground.

There are many definitions of GSD. The value of this attribute should be related to the spatial resolution at the sensor, rather than the pixel size of images after ortho-rectification, pansharpening, or scaling. The GSD of a sensor can vary depending on off-nadir and wavelength, so it is at the discretion of the implementer to decide which value most accurately represents the GSD. For example, Landsat8 optical and short-wave IR bands are all 30 meters, but the panchromatic band is 15 meters. The gsd should be 30 meters in this case because that is nominal spatial resolution at the sensor. The Planet PlanetScope Ortho Tile Product has an gsd of 3.7 (or 4 if rounding), even though the pixel size of the images is 3.125. For example, one might choose for WorldView-2 the Multispectral 20° off-nadir value of 2.07 and for WorldView-3 the Multispectral 20° off-nadir value of 1.38.

createdstring date-time required

RFC 3339 compliant datetime string, time when the object was created

updatedstring date-time required

RFC 3339 compliant datetime string, time when the object was updated

Example response

{
  "id": "smr50-263-2016-2056-kgrs-2.5.tiff",
  "type": "image/tiff; application=geotiff",
  "title": "Thumbnail",
  "href": "http://data.geo.admin.ch/ch.swisstopo.swissimage/collections/cs/items/CS3-20160503_132130_04/thumb.png\n",
  "file:checksum": "90e402107a7f2588a85362b9beea2a12d4514d45",
  "roles": [
    "thumbnail"
  ],
  "geoadmin:variant": "komb",
  "proj:epsg": 2056,
  "gsd": 2.5,
  "created": "2018-02-12T23:20:50Z",
  "updated": "2018-02-12T23:20:50Z",
  "links": [
    {
      "href": "https://data.geo.admin.ch/api/stac/v1/collections/ch.swisstopo.pixelkarte-farbe-pk50.noscale/assets/smr50-263-2016-2056-kgrs-2.5.tiff",
      "rel": "self"
    },
    {
      "href": "https://data.geo.admin.ch/api/stac/v1/",
      "rel": "root"
    },
    {
      "href": "https://data.geo.admin.ch/api/stac/v1/collections/ch.swisstopo.pixelkarte-farbe-pk50.noscale/assets",
      "rel": "parent"
    },
    {
      "href": "https://data.geo.admin.ch/api/stac/v1/collections/ch.swisstopo.pixelkarte-farbe-pk50.noscale",
      "rel": "collection"
    }
  ]
}