Fetch collections
Changed onThe feature collections in the dataset
Request
- Base URLhttp://data.geo.admin.ch/api/stac/v0.9
- Authnone declared
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
The limit parameter limits the number of results that are included in the response.
To retrieve the next bunch of result, use the next link in the links section of the response.
Minimum = 1. Maximum = 100. Default = 100.
Response
The feature collections shared by this API.
The dataset is organized as one or more feature collections. This resource provides information about and access to the collections.
The response contains the list of collections. For each collection, a link to the items in the collection (path /collections/{collectionId}/items, link relation items) as well as key information about the collection. This information includes:
- A local identifier for the collection that is unique for the dataset
- A list of coordinate reference systems (CRS) in which geometries may be returned by the server. The first CRS is the default coordinate reference system (the default is always WGS 84 with axis order longitude/latitude)
- An optional title and description for the collection
- An optional extent that can be used to provide an indication of the spatial and temporal extent of the collection - typically derived from the data
- An optional indicator about the type of the items in the collection (the default value, if the indicator is not provided, is 'feature'). The limit parameter may be used to control the subset of the selected collections that should be returned in the response, the page size. Each page include links to support paging (link relation next and/or previous).
Example response
{
"collections": [
{
"crs": [
"http://www.opengis.net/def/crs/OGC/1.3/CRS84"
],
"description": "Swiss Map Raster are a conversion of the map image into a digital form with no direct bearing on the individual map elements.\n\nThe information is structured only in colour layers. Swiss Map Raster pixel maps are ideal for finding background information for a broad variety of screen applications, web and mobile applications and services, as well as for geographic information systems. They can also be used as basic maps for a variety of purposes (digital printing, plots, offset printing, etc.).",
"extent": {
"spatial": {
"bbox": [
[
5.685114,
45.534903,
10.747775,
47.982586
]
]
},
"temporal": {
"interval": [
[
"2019-01-01T00:00:00Z",
"2019-01-02T00:00:00Z"
]
]
}
},
"id": "ch.swisstopo.pixelkarte-farbe-pk200.noscale",
"license": "proprietary",
"providers": [
{
"name": "Federal Office of Topography - swisstopo",
"roles": [
"producer",
"licensor"
],
"url": "https://www.swisstopo.admin.ch"
}
],
"stac_version": "0.9.0",
"summaries": {
"eo:gsd": [
10,
20
],
"geoadmin:variant": [
"kgrel",
"komb",
"krel"
],
"geoadmin:lang": [
"de",
"fr"
],
"proj:epsg": [
2056
]
},
"title": "National Map 1:200'000",
"created": "2018-02-12T23:20:50Z",
"updated": "2018-02-12T23:20:50Z",
"links": [
{
"href": "https://data.geo.admin.ch/api/stac/v0.9/collections/ch.swisstopo.pixelkarte-farbe-pk50.noscale",
"rel": "self"
},
{
"href": "https://data.geo.admin.ch/api/stac/v0.9/",
"rel": "root"
},
{
"href": "https://data.geo.admin.ch/api/stac/v0.9",
"rel": "parent"
},
{
"href": "https://data.geo.admin.ch/api/stac/v0.9/collections/ch.swisstopo.pixelkarte-farbe-pk50.noscale/items",
"rel": "items"
},
{
"href": "https://www.swisstopo.admin.ch/en/home/meta/conditions/geodata/free-geodata.html",
"rel": "license",
"title": "Licence for the free geodata of the Federal Office of Topography swisstopo"
},
{
"href": "https://www.geocat.ch/geonetwork/srv/eng/catalog.search#/metadata/4c8c7c58-61c7-4a61-8e7a-6ffb95d183df",
"rel": "describedby"
}
]
}
],
"links": [
{
"href": "https://data.geo.admin.ch/api/stac/v0.9/collections",
"rel": "self"
},
{
"href": "https://data.geo.admin.ch/api/stac/v0.9/",
"rel": "root"
},
{
"href": "https://data.geo.admin.ch/api/stac/v0.9/collections?cursor=10ab",
"rel": "next"
},
{
"href": "https://data.geo.admin.ch/api/stac/v0.9/collections?cursor=10cd",
"rel": "previous"
}
]
}Changes
- breaking
the
response's property type changed frominttointegerfor status - breaking
the
/response's property type changed fromobjectto no type for status - breaking
removed the required property
//from the response with the status - breaking
removed the required property
//from the response with the status - breaking
removed the required property
//from the response with the status - breaking
removed the required property
//from the response with the status - breaking
removed the required property
//from the response with the status - breaking
removed the required property
//from the response with the status - breaking
removed the required property
//from the response with the status - breaking
removed the required property
//from the response with the status - warning
removed the optional property
//from the response with the status - warning
removed the optional property
//from the response with the status - warning
removed the optional property
//from the response with the status - warning
removed the optional property
//from the response with the status - warning
removed the optional property
//from the response with the status - info
added
subschema #2to the/response propertyallOflist for the response status
- breaking
- warning
removed the optional property
//from the response with the status
- warning