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
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 }{ "url": "