GET

Raster Instance

API endpoint for rasterlayer objects.

Rasterlayers visualise raster data. The actual data is contained in rastersources. To connect a rasterlayer to a rastersource, configure the rasterlayer's source field as follows:

{
    "graph": {
        "rastersource": [
            "lizard_nxt.blocks.LizardRasterSource",
            "<uuid of a rastersource object>"
        ]
    },
    "name": "rastersource"
}

Note that the organisations of the rastersource and rasterlayer should be equal. The raster_sources field cannot be used to configure the source: it is merely a (read-only) hyperlink to the /rastersources endpoint.

GeoBlocks

Instead of directly visualising a raster source, raster layers can also perform on-the-fly operations on multiple raster sources. This can be done by extending the above example for the source field. See https://docs.lizard.net. Note that the rasterlayers's organisation must have geoblocks-permissions to be able to use this feature.

Deletion

If a rasterlayer is deleted, its raster sources (see /rastersources endpoint) will remain available. These need to be cleaned up seperately, or else they will keep using space.

If a rastersource was deleted while there was a rasterlayer referencing it, the rasterlayer will become broken. In this case, the deleted rastersources will be listed in the source.deleted_sources field.

Query parameters:

name Text filter on the name field. All text field filter methods, like startswith, endswith, icontains are supported.

uuid Filter on uuid field. UUIDs must be separated by commas and must be specified in their canonical textual representation (in their 8-4-4-4-12 form, that is). Filtering is case insensitive and may be done across relationships.

organisation Filter on Organisations.

observation_type Filter on ObservationType.

layer_collections Filter on LayerCollection.

first_value_timestamp Temporal filter on first_value_timestamp.

last_value_timestamp Temporal filter on last_value_timestamp.

raster_sources__uuid Show rasters that make use of a raster_source with given uuid.

access_modifier Filter on access_modifier, options are 'Public', 'Private', 'Common', or 'Hidden'.

ordering Show the results in a specific order. You can order them by name, last_modified, supplier, temporal, access_modifier, first_value_timestamp, last_value_timestamp, observation_type, observation_type__code, observation_type__parameter, observation_type__unit, and organisation__name. Add a - in front to reverse the order.

created: Temporal filter on created. Supports various lookup types (exact, lt, lte, gt, gte; created__exact by default). Filter values should be specified in ISO 8601 YYYY-MM-DDThh:mm:ssZ format.

last_modified: Temporal filter on last_modified. Supports various lookup types (exact, lt, lte, gt, gte; last_modified__exact by default). Filter values should be specified in ISO 8601 YYYY-MM-DDThh:mm:ssZ format.

Examples

?name__icontains=Elevation

?organisation__name=DDSC

?organisation__uuid=61f5a464c35044c19bc7d4b42d7f58cb

?organisation__name__startswith=Nelen

?organisation__name__icontains=Schuur

?observation_type__code=HOOGTEmNAP

?observation_type__parameter=Hoogte

?uuid=10415ccb-ec31-4d43-bdb3-db597061527b,
4a544b7a-772b-45fb-9aa4-a69447f34f52

?first_value_timestamp=2016-06-21T06:05:00Z

?first_value_timestamp__lt=2016-06-21T06:05:00Z

?layer_collections__slug=10855cc

?raster_sources__uuid=10415ccb-ec31-4d43-bdb3-db597061527b

?access_modifier=Private

?access_modifier=100

?ordering=name

?ordering=-last_modified

?created__gte=2017-01-01T00:00:00Z

?last_modified__lt=2018-01-01T00:00:00Z

GET /api/v4/rasters/a0bb7693-6d7d-40b6-858a-ec39863c9167/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, DELETE, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "url": "https://demo.lizard.net/api/v4/rasters/a0bb7693-6d7d-40b6-858a-ec39863c9167/?format=api",
    "uuid": "a0bb7693-6d7d-40b6-858a-ec39863c9167",
    "last_modified": "2021-06-24T14:33:28.497100Z",
    "created": "2021-05-10T21:35:39.419078Z",
    "organisation": {
        "url": "https://demo.lizard.net/api/v4/organisations/70b0c750-d234-43b9-bb75-3454b05c2b0d/?format=api",
        "uuid": "70b0c750-d234-43b9-bb75-3454b05c2b0d",
        "name": "Geoblocks demo"
    },
    "access_modifier": "Public",
    "supplier": null,
    "shared_with": [
        {
            "url": "https://demo.lizard.net/api/v4/organisations/517d61f2-6862-4878-9b19-816a58bdf92a/?format=api",
            "uuid": "517d61f2-6862-4878-9b19-816a58bdf92a",
            "name": "Zephyr group"
        }
    ],
    "writable": false,
    "is_geoblock": true,
    "source": {
        "name": "Hillshade",
        "graph": {
            "Source": [
                "dask_geomodeling.raster.combine.Group",
                "RasterStoreSource_9",
                "RasterStoreSource_2",
                "RasterStoreSource_10",
                "RasterStoreSource_3",
                "RasterStoreSource_7",
                "RasterStoreSource_5",
                "RasterStoreSource_8",
                "RasterStoreSource_4",
                "RasterStoreSource_6",
                "RasterStoreSource_1"
            ],
            "Hillshade": [
                "dask_geomodeling.raster.spatial.HillShade",
                "Source",
                10.0,
                315.0,
                0
            ],
            "RasterStoreSource_1": [
                "lizard_nxt.blocks.LizardRasterSource",
                "2bcffbed-0dd6-4e97-94c1-da2a2dd6b716"
            ],
            "RasterStoreSource_2": [
                "lizard_nxt.blocks.LizardRasterSource",
                "208cdd5e-c98b-43ba-8990-438b7dcc6ae3"
            ],
            "RasterStoreSource_3": [
                "lizard_nxt.blocks.LizardRasterSource",
                "fbe2ae45-d9e3-49e2-9083-ad6a604be6f6"
            ],
            "RasterStoreSource_4": [
                "lizard_nxt.blocks.LizardRasterSource",
                "85c79bb9-5a16-4c8e-9b33-7a052a687161"
            ],
            "RasterStoreSource_5": [
                "lizard_nxt.blocks.LizardRasterSource",
                "0174f4df-705b-4455-9d32-6a41b93f66bd"
            ],
            "RasterStoreSource_6": [
                "lizard_nxt.blocks.LizardRasterSource",
                "ec469dde-deed-438e-b62e-4dfdd0abd5cc"
            ],
            "RasterStoreSource_7": [
                "lizard_nxt.blocks.LizardRasterSource",
                "a368e7ae-8d9e-40d0-aa4d-b1a9ee6f209f"
            ],
            "RasterStoreSource_8": [
                "lizard_nxt.blocks.LizardRasterSource",
                "2441d662-472a-418e-b1ec-6f4eb6d29c8b"
            ],
            "RasterStoreSource_9": [
                "lizard_nxt.blocks.LizardRasterSource",
                "8f793070-0f6f-4cf7-a777-bf36e2004041"
            ],
            "RasterStoreSource_10": [
                "lizard_nxt.blocks.LizardRasterSource",
                "4a64b689-c8c0-4145-8050-382804a1f5eb"
            ]
        }
    },
    "weight": 12,
    "raster_sources": [
        "https://demo.lizard.net/api/v4/rastersources/ec469dde-deed-438e-b62e-4dfdd0abd5cc/?format=api",
        "https://demo.lizard.net/api/v4/rastersources/2441d662-472a-418e-b1ec-6f4eb6d29c8b/?format=api",
        "https://demo.lizard.net/api/v4/rastersources/2bcffbed-0dd6-4e97-94c1-da2a2dd6b716/?format=api",
        "https://demo.lizard.net/api/v4/rastersources/85c79bb9-5a16-4c8e-9b33-7a052a687161/?format=api",
        "https://demo.lizard.net/api/v4/rastersources/fbe2ae45-d9e3-49e2-9083-ad6a604be6f6/?format=api",
        "https://demo.lizard.net/api/v4/rastersources/4a64b689-c8c0-4145-8050-382804a1f5eb/?format=api",
        "https://demo.lizard.net/api/v4/rastersources/8f793070-0f6f-4cf7-a777-bf36e2004041/?format=api",
        "https://demo.lizard.net/api/v4/rastersources/0174f4df-705b-4455-9d32-6a41b93f66bd/?format=api",
        "https://demo.lizard.net/api/v4/rastersources/208cdd5e-c98b-43ba-8990-438b7dcc6ae3/?format=api",
        "https://demo.lizard.net/api/v4/rastersources/a368e7ae-8d9e-40d0-aa4d-b1a9ee6f209f/?format=api"
    ],
    "name": "Hillshade World",
    "description": "Demo of Hillshade GeoBlock on the World DEM",
    "observation_type": {
        "url": "https://demo.lizard.net/api/v4/observationtypes/845/?format=api",
        "id": 845,
        "code": "Elevation(mMSL)",
        "parameter": "Elevation",
        "unit": "m",
        "scale": "interval",
        "description": "",
        "domain_values": null,
        "reference_frame": "MSL",
        "compartment": "",
        "created": "2017-08-21T12:22:55.356966Z",
        "last_modified": "2019-06-25T07:26:10.441021Z"
    },
    "temporal": false,
    "layer_collections": [
        {
            "url": "https://demo.lizard.net/api/v4/layercollections/SLAMDAM%20Burundi/?format=api",
            "slug": "SLAMDAM Burundi",
            "organisation": {
                "url": "https://demo.lizard.net/api/v4/organisations/517d61f2-6862-4878-9b19-816a58bdf92a/?format=api",
                "uuid": "517d61f2-6862-4878-9b19-816a58bdf92a",
                "name": "Zephyr group"
            },
            "access_modifier": "Public",
            "supplier": "chris.kerklaan",
            "created": "2021-02-10T16:00:52.866921Z",
            "last_modified": "2022-02-14T22:12:48.018510Z"
        }
    ],
    "first_value_timestamp": "1970-01-01T00:00:00Z",
    "last_value_timestamp": "1970-01-01T00:00:00Z",
    "spatial_bounds": {
        "west": -180.00208333333333,
        "east": 180.00000000014398,
        "north": 85.05208333333333,
        "south": -85.05208333333334
    },
    "projection": null,
    "origin_x": null,
    "origin_y": null,
    "upper_bound_x": null,
    "upper_bound_y": null,
    "pixelsize_x": null,
    "pixelsize_y": null,
    "interval": null,
    "wms_info": {
        "endpoint": "https://demo.lizard.net/wms/",
        "layer": "geoblocks-demo:hillshade-world"
    },
    "options": {
        "styles": "hill"
    },
    "colormap": {},
    "rescalable": true,
    "aggregation_type": "curve",
    "dtype": null,
    "fill_value": null
}