v39

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

Data

Fetch a single feature

Fetch the feature with id featureId in the feature collection with id collectionId.

Use content negotiation to request HTML or GeoJSON.

get/collections/{collectionId}/items/{featureId}

Path parameters

collectionIdstring required

Local identifier of a collection

featureIdstring required

Local identifier of a feature

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

Fetch the feature with id featureId in the feature collection with id collectionId

idstring required

Feature identifier (unique per collection)

assetsItemAssets required

List of Assets attached to this feature.

bboxnumber[] required

The bounding box is provided as four numbers:

Lower left corner, coordinate axis 1
Lower left corner, coordinate axis 2
Upper right corner, coordinate axis 1
Upper right corner, coordinate axis 2

The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).

For WGS84 longitude/latitude the values are in most cases the sequence of minimum longitude, minimum latitude, maximum longitude and maximum latitude. However, in cases where the box spans the antimeridian the first value (west-most box edge) is larger than the third value (east-most box edge).

Example: The bounding box of Switzerland in WGS 84 (from 5.96°E to 10.49°E and from 45.82°N to 47.81°N) would be represented in JSON as [5.96, 45.82, 10.49, 47.81] and in a query as bbox=5.96,45.82,10.49,47.81."

stac_versionstring required

stac_extensionsstring[]

List of relevant extensions for an object

type'Feature' required

The GeoJSON type

Example response

{
  "id": "smr200-200-4-2019",
  "links": [
    {
      "href": "https://data.geo.admin.ch/api/stac/v1/collections/ch.swisstopo.pixelkarte-farbe-pk50.noscale/items/smr50-263-2016",
      "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",
      "rel": "parent"
    },
    {
      "href": "https://data.geo.admin.ch/api/stac/v1/collections/ch.swisstopo.pixelkarte-farbe-pk50.noscale",
      "rel": "collection"
    }
  ],
  "assets": {
    "smr50-263-2016-2056-kgrs-2.5.tiff": {
      "file:checksum": "12200ADEC47F803A8CF1055ED36750B3BA573C79A3AF7DA6D6F5A2AED03EA16AF3BC",
      "created": "2020-07-14T12:30:00Z",
      "gsd": 2.5,
      "geoadmin:variant": "kgrs",
      "href": "https://data.geo.admin.ch/ch.swisstopo.pixelkarte-farbe-pk50.noscale/smr50-263-2016-2056-kgrs-2.5.tiff",
      "proj:epsg": 2056,
      "type": "image/tiff; application=geotiff",
      "updated": "2020-07-14T12:30:00Z"
    },
    "smr50-263-2016-2056-komb-2.5.tiff": {
      "file:checksum": "12200ADEC47F803A8CF1055ED36750B3BA573C79A3AF7DA6D6F5A2AED03EA16AF3BC",
      "created": "2020-07-14T12:30:00Z",
      "gsd": 2.5,
      "geoadmin:variant": "komb",
      "href": "https://data.geo.admin.ch/ch.swisstopo.pixelkarte-farbe-pk50.noscale/smr50-263-2016-2056-komb-2.5.tiff",
      "proj:epsg": "2056",
      "type": "image/tiff; application=geotiff",
      "updated": "2020-07-14T12:30:00Z"
    },
    "smr50-263-2016-2056-krel-2.5.tiff": {
      "file:checksum": "12200ADEC47F803A8CF1055ED36750B3BA573C79A3AF7DA6D6F5A2AED03EA16AF3BC",
      "created": "2020-07-14T12:30:00Z",
      "gsd": 2.5,
      "geoadmin:variant": "krel",
      "href": "https://data.geo.admin.ch/ch.swisstopo.pixelkarte-farbe-pk50.noscale/smr50-263-2016-2056-krel-2.5.tiff",
      "proj:epsg": "2056",
      "type": "image/tiff; application=geotiff",
      "updated": "2020-07-14T12:30:00Z"
    }
  },
  "bbox": [
    7.0906249,
    45.9160584,
    7.1035698,
    45.925093
  ],
  "geometry": {
    "coordinates": [
      7.0906823,
      45.9160584
    ]
  },
  "properties": {
    "created": "2018-02-12T23:20:50Z",
    "datetime": "2018-02-12T23:20:50Z",
    "start_datetime": "2018-02-12T23:20:50Z",
    "end_datetime": "2018-02-12T23:20:50Z",
    "expires": "2018-02-12T23:20:50Z",
    "updated": "2018-02-12T23:20:50Z",
    "title": "Feature title",
    "forecast:reference_datetime": "2018-02-12T23:20:50Z",
    "forecast:horizon": "P3DT6H",
    "forecast:duration": "P3DT6H",
    "forecast:variable": "air_temperature"
  },
  "stac_version": "1.0.0",
  "stac_extensions": [
    "https://stac-extensions.github.io/forecast/v0.2.0/schema.json"
  ]
}