Skip to main content

data

Creates, updates, deletes, gets or lists a data resource.

Overview

Namedata
TypeResource
Idazure.planetary_computer_dataplane.data

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringUnique identifier for the feature. Required.
assetsobjectAssets. Required.
bboxarrayBounding box coordinates for the feature. Required.
collectionstringID of the STAC collection this item belongs to.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_search_assets_for_tileselectsearch_id, tile_matrix_set_id, z, x, y, collection, endpointscan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_methodSearches Assets For Tile Tilematrixsetid As Path. Return a list of assets which overlap a given tile.
get_collection_assets_for_tileselectcollection_id, tile_matrix_set_id, z, x, y, endpointscan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_methodCollection Assets For Tile Tilematrixsetid As Path. Return a list of assets which overlap a given tile for a STAC collection (with TileMatrixSetId).
get_item_feature_statisticsselectcollection_id, item_id, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, coord_crs, resampling, max_size, categorical, c, p, histogram_bins, histogram_range, dst_crs, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, height, widthItem Geojson Statistics. Get statistics from a GeoJSON feature for a STAC item.
get_item_pointselectcollection_id, item_id, longitude, latitude, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, subdataset_name, subdataset_bands, crs, datetime, sel_method, coord_crs, resamplingItem Point. Get point value for a STAC item dataset.
get_tileset_metadataselectcollection_id, item_id, tile_matrix_set_id, endpointsubdataset_name, subdataset_bands, crs, datetime, sel_methodTileset Metadata. Return metadata for a specific tileset of a STAC item.
get_collection_pointselectcollection_id, longitude, latitude, endpointscan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, expression, asset_bidx, asset_as_band, nodata, unscale, reproject, coord_crs, resamplingCollection Point. Get Point value for a collection dataset.
get_search_pointselectsearch_id, longitude, latitude, endpointscan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, expression, asset_bidx, asset_as_band, nodata, unscale, reproject, coord_crs, resamplingSearches Point. Get Point value for a search dataset.
get_tilesetsselectcollection_id, item_id, endpointsubdataset_name, subdataset_bands, crs, datetime, sel_methodTileset List. Return a list of available tilesets for a STAC item.
get_collection_tileset_metadataselectcollection_id, tile_matrix_set_id, endpointids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_methodCollection Tileset Metadata. Return metadata for a specific tileset of a STAC collection.
get_search_tileset_metadataselectsearch_id, tile_matrix_set_id, endpointsubdataset_name, subdataset_bands, crs, datetime, sel_methodSearches Tileset Metadata. Return metadata for a specific tileset of a mosaic search.
get_tile_matrix_definitionsselecttile_matrix_set_id, endpointMatrix Definition. Return Matrix Definition.
get_collection_tilesetsselectcollection_id, endpointids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_methodCollection Tileset List. Return a list of available tilesets for a STAC collection.
get_search_tilesetsselectsearch_id, endpointsubdataset_name, subdataset_bands, crs, datetime, sel_methodSearches Tileset List. Return a list of available tilesets for a mosaic search.
get_tile_matricesselectendpointMatrix List. Return Matrix List.
get_class_map_legendexecclassmap_name, endpointtrim_start, trim_endGet ClassMap Legend. Generate values and color swatches mapping for a given classmap.
get_interval_legendexecclassmap_name, endpointtrim_start, trim_endGet Interval Legend. Generate values and color swatches mapping for a given interval classmap. Returns a color map for intervals, where each interval is defined by a numeric range [min, max] representing the interval boundaries and an RGBA color [red, green, blue, alpha] associated with the interval. The response is a 2D array of interval definitions, where each element is a pair: the first element is an array of two numbers [min, max] defining the interval, and the second element is an array of four numbers [red, green, blue, alpha] defining the RGBA color. Example: [[ [-2, 0], [0, 0, 0, 0] ], [ [1, 32], [255, 255, 178, 255] ]]. This defines two intervals: [-2, 0] mapped to transparent black and [1, 32] mapped to opaque yellow.
get_legendexeccolor_map_name, endpointheight, width, trim_start, trim_endGet Legend. Generate a legend image for a given colormap. If the colormap has non-contiguous values at the beginning or end, which aren't desired in the output image, they can be trimmed by specifying the number of values to trim.
get_tileexeccollection_id, item_id, tile_matrix_set_id, z, x, y, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, format, scale, buffer, color_formula, resampling, colormap_name, colormap, return_mask, padding, subdataset_name, subdataset_bands, crs, datetime, sel_methodTile Tilematrixsetid Plain. Create map tile from a dataset (without scale or format in path).
get_tile_by_formatexeccollection_id, item_id, tile_matrix_set_id, z, x, y, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, scale, buffer, color_formula, resampling, colormap_name, colormap, return_mask, padding, subdataset_name, subdataset_bands, crs, datetime, sel_methodTile Tilematrixsetid Format. Create map tile from a dataset (with format in path, without scale).
get_tile_by_scaleexeccollection_id, item_id, tile_matrix_set_id, z, x, y, scale, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, format, buffer, color_formula, resampling, colormap_name, colormap, return_mask, padding, subdataset_name, subdataset_bands, crs, datetime, sel_methodTile Tilematrixsetid Scale. Create map tile from a dataset (with scale in path, without format).
get_tile_by_scale_and_formatexeccollection_id, item_id, tile_matrix_set_id, z, x, y, scale, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, buffer, color_formula, resampling, colormap_name, colormap, return_mask, padding, subdataset_name, subdataset_bands, crs, datetime, sel_methodTile Tilematrixsetid. Create map tile from a dataset (with TileMatrixSetId, scale, and format in path).
get_tile_no_tmsexeccollection_id, item_id, z, x, y, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, TileMatrixSetId, format, scale, buffer, color_formula, resampling, colormap_name, colormap, return_mask, padding, subdataset_name, subdataset_bands, crs, datetime, sel_methodTile Plain. Create map tile from a dataset (without TileMatrixSetId, scale or format in path).
get_tile_no_tms_by_formatexeccollection_id, item_id, z, x, y, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, TileMatrixSetId, scale, buffer, color_formula, resampling, colormap_name, colormap, return_mask, padding, subdataset_name, subdataset_bands, crs, datetime, sel_methodTile Format. Create map tile from a dataset (with format in path, without TileMatrixSetId or scale).
get_tile_no_tms_by_scaleexeccollection_id, item_id, z, x, y, scale, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, TileMatrixSetId, format, buffer, color_formula, resampling, colormap_name, colormap, return_mask, padding, subdataset_name, subdataset_bands, crs, datetime, sel_methodTile Scale. Create map tile from a dataset (with scale in path, without TileMatrixSetId or format).
get_tile_no_tms_by_scale_and_formatexeccollection_id, item_id, z, x, y, scale, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, TileMatrixSetId, buffer, color_formula, resampling, colormap_name, colormap, return_mask, padding, subdataset_name, subdataset_bands, crs, datetime, sel_methodTile. Create map tile from a dataset (with scale and format in path, without TileMatrixSetId).
get_item_boundsexeccollection_id, item_id, endpointsubdataset_name, subdataset_bands, crs, datetime, sel_methodItem Bounds. Return the bounds for a STAC item.
get_item_infoexeccollection_id, item_id, endpointsubdataset_name, subdataset_bands, crs, datetime, sel_methodItem Info. Return dataset's basic info for a STAC item.
get_item_info_geo_jsonexeccollection_id, item_id, endpointsubdataset_name, subdataset_bands, crs, datetime, sel_methodItem Info Geojson. Return info as GeoJSON for a STAC item.
get_item_available_assetsexeccollection_id, item_id, endpointsubdataset_name, subdataset_bands, crs, datetime, sel_methodItem Available Assets. Return a list of supported assets for a STAC item.
get_item_asset_statisticsexeccollection_id, item_id, endpointasset_bidx, nodata, unscale, reproject, resampling, max_size, categorical, c, p, histogram_bins, histogram_range, subdataset_name, subdataset_bands, crs, datetime, sel_method, asset_expression, height, widthItem Asset Statistics. Per asset statistics for a STAC item.
get_item_statisticsexeccollection_id, item_id, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, resampling, max_size, categorical, c, p, histogram_bins, histogram_range, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, height, widthItem Statistics. Merged assets statistics for a STAC item.
get_item_tile_jsonexeccollection_id, item_id, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, TileMatrixSetId, tile_format, tile_scale, minzoom, maxzoom, buffer, color_formula, resampling, colormap_name, colormap, return_mask, padding, subdataset_name, subdataset_bands, crs, datetime, sel_methodItem TileJson. Return TileJSON document for a STAC item.
get_item_tile_json_by_tmsexeccollection_id, item_id, tile_matrix_set_id, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, tile_format, tile_scale, minzoom, maxzoom, buffer, color_formula, resampling, colormap_name, colormap, return_mask, padding, subdataset_name, subdataset_bands, crs, datetime, sel_methodItem TileJson Tilematrixsetid As Path. Return TileJSON document for a STAC item with TileMatrixSetId as path.
get_item_wmts_capabilitiesexeccollection_id, item_id, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, TileMatrixSetId, tile_format, tile_scale, minzoom, maxzoom, buffer, color_formula, resampling, colormap_name, colormap, return_mask, padding, subdataset_name, subdataset_bands, crs, datetime, sel_methodItem Wmts. OGC WMTS endpoint for a STAC item.
get_item_wmts_capabilities_by_tmsexeccollection_id, item_id, tile_matrix_set_id, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, tile_format, tile_scale, minzoom, maxzoom, buffer, color_formula, resampling, colormap_name, colormap, return_mask, padding, subdataset_name, subdataset_bands, crs, datetime, sel_methodItem Wmts Tilematrixsetid As Path. OGC WMTS endpoint for a STAC item with TileMatrixSetId as path.
get_item_previewexeccollection_id, item_id, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, format, color_formula, dst_crs, resampling, max_size, height, width, colormap_name, colormap, return_mask, subdataset_name, subdataset_bands, crs, datetime, sel_methodItem Preview. Create preview of a STAC item dataset.
get_item_preview_with_formatexeccollection_id, item_id, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, color_formula, dst_crs, resampling, max_size, height, width, colormap_name, colormap, return_mask, subdataset_name, subdataset_bands, crs, datetime, sel_methodItem Preview With Format. Create preview of a STAC item dataset with format.
get_item_bbox_cropexeccollection_id, item_id, minx, miny, maxx, maxy, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, color_formula, coord_crs, dst_crs, resampling, max_size, height, width, colormap_name, colormap, return_mask, subdataset_name, subdataset_bands, crs, datetime, sel_methodItem Bbox. Create an image from part of a STAC item dataset (bounding box crop).
get_item_bbox_crop_with_dimensionsexeccollection_id, item_id, minx, miny, maxx, maxy, width, height, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, color_formula, coord_crs, dst_crs, resampling, max_size, colormap_name, colormap, return_mask, subdataset_name, subdataset_bands, crs, datetime, sel_methodItem Bbox With Dimensions. Create an image from part of a STAC item dataset (bounding box crop with dimensions).
get_collection_tile_by_scale_and_formatexeccollection_id, tile_matrix_set_id, z, x, y, scale, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingCollection Tile Tilematrixsetid. Create map tile for a STAC collection (with TileMatrixSetId, scale, and format in path).
get_collection_tileexeccollection_id, tile_matrix_set_id, z, x, y, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, format, scale, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingCollection Tile Tilematrixsetid Plain. Create map tile for a STAC collection (with TileMatrixSetId, without scale or format).
get_collection_tile_by_formatexeccollection_id, tile_matrix_set_id, z, x, y, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, scale, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingCollection Tile Tilematrixsetid Format. Create map tile for a STAC collection (with TileMatrixSetId and format, without scale).
get_collection_tile_by_scaleexeccollection_id, tile_matrix_set_id, z, x, y, scale, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, format, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingCollection Tile Tilematrixsetid Scale. Create map tile for a STAC collection (with TileMatrixSetId and scale, without format).
get_collection_tile_no_tms_by_scale_and_formatexeccollection_id, z, x, y, scale, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, TileMatrixSetId, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingCollection Tile. Create map tile for a STAC collection (without TileMatrixSetId, with scale and format).
get_collection_tile_no_tmsexeccollection_id, z, x, y, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, TileMatrixSetId, format, scale, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingCollection Tile Plain. Create map tile for a STAC collection (without TileMatrixSetId, scale, or format).
get_collection_tile_no_tms_by_formatexeccollection_id, z, x, y, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, TileMatrixSetId, scale, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingCollection Tile Format. Create map tile for a STAC collection (with format, without TileMatrixSetId or scale).
get_collection_tile_no_tms_by_scaleexeccollection_id, z, x, y, scale, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, TileMatrixSetId, format, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingCollection Tile Scale. Create map tile for a STAC collection (with scale, without TileMatrixSetId or format).
get_collection_tile_jsonexeccollection_id, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, TileMatrixSetId, tile_format, tile_scale, minzoom, maxzoom, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingCollection TileJson. Return TileJSON document for a STAC collection.
get_collection_tile_json_by_tmsexeccollection_id, tile_matrix_set_id, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, tile_format, tile_scale, minzoom, maxzoom, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingCollection TileJson Tilematrixsetid As Path. Return TileJSON document for a STAC collection with TileMatrixSetId as path.
get_collection_wmts_capabilitiesexeccollection_id, endpointids, bbox, query, sortby, datetime, TileMatrixSetId, tile_format, tile_scale, minzoom, maxzoom, expression, asset_bidx, asset_as_band, nodata, unscale, reprojectCollection Wmts. OGC WMTS endpoint for a STAC collection.
get_collection_wmts_capabilities_by_tmsexeccollection_id, tile_matrix_set_id, endpointids, bbox, query, sortby, datetime, tile_format, tile_scale, minzoom, maxzoom, expression, asset_bidx, asset_as_band, nodata, unscale, reprojectCollection Wmts Tilematrixsetid As Path. OGC WMTS endpoint for a STAC collection with TileMatrixSetId as path.
get_collection_assets_for_tile_no_tmsexeccollection_id, z, x, y, endpointscan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, TileMatrixSetIdCollection Assets For Tile. Return a list of assets which overlap a given tile for a STAC collection (without TileMatrixSetId).
get_collection_assets_for_bboxexeccollection_id, minx, miny, maxx, maxy, endpointscan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, coord_crsCollection Assets For Bbox. Return a list of assets which overlap a given bounding box for a STAC collection.
get_collection_infoexeccollection_id, endpointCollection Info. Return search query info from a STAC collection identifier.
get_collection_bbox_cropexeccollection_id, minx, miny, maxx, maxy, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, coord_crs, dst_crs, max_size, height, width, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_maskCollection Bbox. Create an image from part of a STAC collection dataset (bounding box crop).
get_collection_bbox_crop_with_dimensionsexeccollection_id, minx, miny, maxx, maxy, width, height, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, coord_crs, dst_crs, max_size, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_maskCollection Bbox With Dimensions. Create an image from part of a STAC collection dataset (bounding box crop with dimensions).
get_collection_point_assetsexeccollection_id, longitude, latitude, endpointscan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, coord_crsCollection Point Assets. Return a list of assets for a given point in a collection.
get_search_tile_by_scale_and_formatexecsearch_id, tile_matrix_set_id, z, x, y, scale, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingSearches Tile Tilematrixsetid. Create map tile (with TileMatrixSetId, scale, and format in path).
get_search_tileexecsearch_id, tile_matrix_set_id, z, x, y, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, format, scale, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingSearches Tile Tilematrixsetid Plain. Create map tile (with TileMatrixSetId, without scale or format).
get_search_tile_by_formatexecsearch_id, tile_matrix_set_id, z, x, y, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, scale, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingSearches Tile Tilematrixsetid Format. Create map tile (with TileMatrixSetId and format, without scale).
get_search_tile_by_scaleexecsearch_id, tile_matrix_set_id, z, x, y, scale, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, format, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingSearches Tile Tilematrixsetid Scale. Create map tile (with TileMatrixSetId and scale, without format).
get_search_tile_json_by_tmsexecsearch_id, tile_matrix_set_id, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, minzoom, maxzoom, tile_format, tile_scale, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingSearches TileJson Tilematrixsetid As Path. Return TileJSON document for a search with TileMatrixSetId as path.
get_search_wmts_capabilities_by_tmsexecsearch_id, tile_matrix_set_id, endpointtile_format, tile_scale, minzoom, maxzoom, expression, asset_bidx, asset_as_band, nodata, unscale, reprojectSearches Wmts Tilematrixsetid As Path. OGC WMTS endpoint with TileMatrixSetId as path.
get_search_infoexecsearch_id, endpointSearches Info. Get Search query metadata.
get_search_bbox_cropexecsearch_id, minx, miny, maxx, maxy, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, coord_crs, dst_crs, max_size, height, width, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_maskSearches Bbox. Create an image from part of a dataset (bounding box crop).
get_search_bbox_crop_with_dimensionsexecsearch_id, minx, miny, maxx, maxy, width, height, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, coord_crs, dst_crs, max_size, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_maskSearches Bbox With Dimensions. Create an image from part of a dataset (bounding box crop with dimensions).
get_search_bbox_assetsexecsearch_id, minx, miny, maxx, maxy, endpointscan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, coord_crsSearches Assets For Bbox. Return a list of assets which overlap a given bounding box for a search.
get_search_wmts_capabilitiesexecsearch_id, endpointTileMatrixSetId, tile_format, tile_scale, minzoom, maxzoom, expression, asset_bidx, asset_as_band, nodata, unscale, reprojectSearches Wmts. OGC WMTS endpoint.
get_search_tile_jsonexecsearch_id, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, TileMatrixSetId, tile_format, tile_scale, minzoom, maxzoom, padding, buffer, color_formula, collection, resampling, pixel_selection, algorithm, algorithm_params, colormap_name, colormap, return_maskSearches TileJson. Return TileJSON document for a search.
get_search_tile_no_tmsexecsearch_id, z, x, y, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, TileMatrixSetId, format, scale, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingSearches Tile Plain. The most basic operation.
get_search_tile_no_tms_by_formatexecsearch_id, z, x, y, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, TileMatrixSetId, scale, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingSearches Tile Format. The most basic operation.
get_search_tile_no_tms_by_scaleexecsearch_id, z, x, y, scale, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, TileMatrixSetId, format, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingSearches Tile Scale. The most basic operation.
get_search_tile_no_tms_by_scale_and_formatexecsearch_id, z, x, y, scale, format, endpointexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, TileMatrixSetId, buffer, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, paddingSearches Tile. The most basic operation.
get_search_assets_for_tile_no_tmsexecsearch_id, z, x, y, endpointscan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, TileMatrixSetIdSearches Assets For Tile. The most basic operation.
get_search_point_with_assetsexecsearch_id, longitude, latitude, endpointscan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, coord_crsSearches Point Assets. Return a list of assets for a given point in a search.
register_mosaics_searchexecendpointRegister Search. Register a Search query.
crop_featureexeccollection_id, item_id, endpoint, geometry, typeexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, color_formula, coord_crs, resampling, max_size, height, width, colormap_name, colormap, return_mask, dst_crs, subdataset_name, subdataset_bands, crs, datetime, sel_method, formatGeojson Feature. Create image from a geojson feature (without format in path).
crop_feature_by_formatexeccollection_id, item_id, format, endpoint, geometry, typeexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, color_formula, coord_crs, resampling, max_size, height, width, colormap_name, colormap, return_mask, dst_crs, subdataset_name, subdataset_bands, crs, datetime, sel_methodGeojson Feature Crop With Format. Create image from a geojson feature with format.
crop_feature_width_by_heightexeccollection_id, item_id, width, height, format, endpoint, geometry, typeexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, algorithm, algorithm_params, color_formula, coord_crs, resampling, max_size, colormap_name, colormap, return_mask, dst_crs, subdataset_name, subdataset_bands, crs, datetime, sel_methodGeojson Feature Crop With Dimensions. Create image from a geojson feature with dimensions.
crop_collection_featureexeccollection_id, endpoint, geometry, typeexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, coord_crs, max_size, height, width, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, dst_crs, formatCollection Geojson Feature. Create image from a geojson feature (without format in path).
crop_collection_feature_by_formatexeccollection_id, format, endpoint, geometry, typeexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, coord_crs, max_size, height, width, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, dst_crsCollection Geojson Feature Crop With Format. Create image from a geojson feature with format.
crop_collection_feature_width_by_heightexeccollection_id, width, height, format, endpoint, geometry, typeexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, ids, bbox, query, sortby, datetime, subdataset_name, subdataset_bands, crs, sel_method, algorithm, algorithm_params, coord_crs, max_size, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, dst_crsCollection Geojson Feature Crop With Dimensions. Create image from a geojson feature with dimensions.
crop_search_featureexecsearch_id, endpoint, geometry, typeexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, coord_crs, max_size, height, width, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, dst_crs, formatSearches Geojson Feature. Create image from a geojson feature (without format in path).
crop_search_feature_by_formatexecsearch_id, format, endpoint, geometry, typeexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, coord_crs, max_size, height, width, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, dst_crsSearches Geojson Feature Crop With Format. Create image from a geojson feature with format.
crop_search_feature_width_by_heightexecsearch_id, width, height, format, endpoint, geometry, typeexpression, asset_bidx, asset_as_band, nodata, unscale, reproject, scan_limit, items_limit, time_limit, exitwhenfull, skipcovered, subdataset_name, subdataset_bands, crs, datetime, sel_method, algorithm, algorithm_params, coord_crs, max_size, color_formula, collection, resampling, pixel_selection, colormap_name, colormap, return_mask, dst_crsSearches Geojson Feature Crop With Dimensions. Create image from a geojson feature with dimensions.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
classmap_namestringclassmap name. Required.
collectionstringSTAC Collection Identifier. Required.
collection_idstringSTAC Collection Identifier. Required.
color_map_namestringThe name of the registered colormap to generate a legend for. Required.
endpointstringThe service endpoint host (no scheme), e.g. myaccount.table.cosmos.azure.com:443 - value of the client endpoint parameter. (default: )
formatstringOutput format for the tile or image (e.g., png, jpeg, webp). Required.
heightintegerHeight in pixels for the output image. Required.
item_idstringSTAC Item Identifier. Required.
latitudenumberLatitude. Required.
longitudenumberLongitude. Required.
maxxnumberBounding box max X. Required.
maxynumberBounding box max Y. Required.
minxnumberBounding box min X. Required.
minynumberBounding box min Y. Required.
scalenumberNumeric scale factor for the tile. Higher values produce larger tiles. Required.
search_idstringSearch Id (pgSTAC Search Hash). Required.
tile_matrix_set_idstringIdentifier selecting one of the TileMatrixSetId supported. Required.
widthintegerWidth in pixels for the output image. Required.
xnumberColumn (X) index of the tile on the selected TileMatrix. It cannot exceed the MatrixHeight-1 for the selected TileMatrix. Required.
ynumberRow (Y) index of the tile on the selected TileMatrix. It cannot exceed the MatrixWidth-1 for the selected TileMatrix. Required.
znumberIdentifier (Z) selecting one of the scales defined in the TileMatrixSet and representing the scaleDenominator the tile. Required.
TileMatrixSetIdstringIdentifier selecting one of the TileMatrixSetId supported (default: 'WebMercatorQuad'). Known values are: "CanadianNAD83_LCC", "EuropeanETRS89_LAEAQuad", "LINZAntarticaMapTilegrid", "NZTM2000Quad", "UPSAntarcticWGS84Quad", "UPSArcticWGS84Quad", "UTM31WGS84Quad", "WGS1984Quad", "WebMercatorQuad", "WorldCRS84Quad", and "WorldMercatorWGS84Quad". Default value is None.
algorithmstringTerrain algorithm name. Known values are: "hillshade", "contours", "normalizedIndex", "terrarium", "terrainrgb", "slope", "cast", "ceil", "floor", "min", "max", "median", "mean", "std", and "var". Default value is None.
algorithm_paramsstringTerrain algorithm parameters. Default value is None.
asset_as_bandbooleanAsset as Band. Default value is None.
asset_bidxarrayPer asset band indexes (coma separated indexes, e.g. "image|1,2,3" means use the bands 1, 2, and 3 from the asset named "image"). Default value is None.
asset_expressionarrayPer asset band expression. Default value is None.
bboxstringBounding box (west, south, east, north). Default value is None.
buffernumberBuffer on each side of the given tile. It must be a multiple of 0.5. Output tilesize will be expanded to tilesize + 2 * buffer (e.g 0.5 = 257x257, 1.0 = 258x258). Default value is None.
carrayList of pixel categorical values for which to report counts. Default value is None.
categoricalbooleanReturn statistics for categorical dataset. Default value is None.
collectionstringSTAC Collection ID. Default value is None.
color_formulastringrio-color formula (info: https://github.com/mapbox/rio-color _). Default value is None.
colormapstringJSON encoded custom Colormap. Default value is None.
colormap_namestringColormap name. Known values are: "accent", "accent_r", "afmhot", "afmhot_r", "ai4g-lulc", "alos-fnf", "alos-palsar-mask", "autumn", "autumn_r", "binary", "binary_r", "blues", "blues_r", "bone", "bone_r", "brbg", "brbg_r", "brg", "brg_r", "bugn", "bugn_r", "bupu", "bupu_r", "bwr", "bwr_r", "c-cap", "cfastie", "chesapeake-lc-13", "chesapeake-lc-7", "chesapeake-lu", "chloris-biomass", "cividis", "cividis_r", "cmrmap", "cmrmap_r", "cool", "cool_r", "coolwarm", "coolwarm_r", "copper", "copper_r", "cubehelix", "cubehelix_r", "dark2", "dark2_r", "drcog-lulc", "esa-cci-lc", "esa-worldcover", "flag", "flag_r", "gap-lulc", "gist_earth", "gist_earth_r", "gist_gray", "gist_gray_r", "gist_heat", "gist_heat_r", "gist_ncar", "gist_ncar_r", "gist_rainbow", "gist_rainbow_r", "gist_stern", "gist_stern_r", "gist_yarg", "gist_yarg_r", "gnbu", "gnbu_r", "gnuplot", "gnuplot2", "gnuplot2_r", "gnuplot_r", "gray", "gray_r", "greens", "greens_r", "greys", "greys_r", "hot", "hot_r", "hsv", "hsv_r", "inferno", "inferno_r", "io-bii", "io-lulc", "io-lulc-9-class", "jet", "jet_r", "jrc-change", "jrc-extent", "jrc-occurrence", "jrc-recurrence", "jrc-seasonality", "jrc-transitions", "lidar-classification", "lidar-hag", "lidar-hag-alternative", "lidar-intensity", "lidar-returns", "magma", "magma_r", "modis-10A1", "modis-10A2", "modis-13A1|Q1", "modis-14A1|A2", "modis-15A2H|A3H", "modis-16A3GF-ET", "modis-16A3GF-PET", "modis-17A2H|A2HGF", "modis-17A3HGF", "modis-64A1", "mtbs-severity", "nipy_spectral", "nipy_spectral_r", "nrcan-lulc", "ocean", "ocean_r", "oranges", "oranges_r", "orrd", "orrd_r", "paired", "paired_r", "pastel1", "pastel1_r", "pastel2", "pastel2_r", "pink", "pink_r", "piyg", "piyg_r", "plasma", "plasma_r", "prgn", "prgn_r", "prism", "prism_r", "pubu", "pubu_r", "pubugn", "pubugn_r", "puor", "puor_r", "purd", "purd_r", "purples", "purples_r", "qpe", "rainbow", "rainbow_r", "rdbu", "rdbu_r", "rdgy", "rdgy_r", "rdpu", "rdpu_r", "rdylbu", "rdylbu_r", "rdylgn", "rdylgn_r", "reds", "reds_r", "rplumbo", "schwarzwald", "seismic", "seismic_r", "set1", "set1_r", "set2", "set2_r", "set3", "set3_r", "spectral", "spectral_r", "spring", "spring_r", "summer", "summer_r", "tab10", "tab10_r", "tab20", "tab20_r", "tab20b", "tab20b_r", "tab20c", "tab20c_r", "terrain", "terrain_r", "twilight", "twilight_r", "twilight_shifted", "twilight_shifted_r", "usda-cdl", "usda-cdl-corn", "usda-cdl-cotton", "usda-cdl-soybeans", "usda-cdl-wheat", "usgs-lcmap", "viirs-10a1", "viirs-13a1", "viirs-14a1", "viirs-15a2H", "viridis", "viridis_r", "winter", "winter_r", "wistia", "wistia_r", "ylgn", "ylgn_r", "ylgnbu", "ylgnbu_r", "ylorbr", "ylorbr_r", "ylorrd", "ylorrd_r", "algae", "algae_r", "amp", "amp_r", "balance", "balance_r", "curl", "curl_r", "deep", "deep_r", "delta", "delta_r", "dense", "dense_r", "diff", "diff_r", "haline", "haline_r", "ice", "ice_r", "matter", "matter_r", "oxy", "oxy_r", "phase", "phase_r", "rain", "rain_r", "solar", "solar_r", "speed", "speed_r", "tarn", "tarn_r", "tempo", "tempo_r", "thermal", "thermal_r", "topo", "topo_r", "turbid", "turbid_r", "turbo", and "turbo_r". Default value is None.
coord_crsstringCoordinate Reference System of the input coords. Default to epsg:4326. Default value is None.
crsstringCoordinate Reference System. Default value is None.
datetimestringDatetime to use for subsetting the asset. Default value is None.
dst_crsstringOutput Coordinate Reference System. Default value is None.
exitwhenfullbooleanReturn as soon as the geometry is fully covered (defaults to True). Default value is None.
expressionstringBand math expression between assets. Default value is None.
formatstringOutput image format. Known values are: "png", "npy", "tif", "jpeg", "jpg", "jp2", "webp", and "pngraw". Default value is None.
heightintegerHeight in pixels for the output image. Default value is None.
histogram_binsstringDefines the number of equal-width bins in the given range (10, by default). If bins is a sequence (comma , delimited values), it defines a monotonically increasing array of bin edges, including the rightmost edge, allowing for non-uniform bin widths. link: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html _. Default value is None.
histogram_rangestringComma , delimited range of the bins. The lower and upper range of the bins. If not provided, range is simply (a.min(), a.max()). Values outside the range are ignored. The first element of the range must be less than or equal to the second. range affects the automatic bin computation as well. link: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html _. Default value is None.
idsstringArray of Item ids. Default value is None.
items_limitintegerReturn as soon as we have N items per geometry (defaults to 100). Default value is None.
max_sizeintegerImage output size limit if width and height limits are not set. Default value is None.
maxzoomintegerOverwrite default maxzoom. Default value is None.
minzoomintegerOverwrite default minzoom. Default value is None.
nodatastringOverwrite internal Nodata value. Default value is None.
parrayList of percentile values (default to [2, 98]). Default value is None.
paddingintegerPadding to apply to each tile edge. Helps reduce resampling artefacts along edges. Defaults to 0. Default value is None.
pixel_selectionstringPixel selection method. Known values are: "first", "highest", "lowest", "mean", "median", "stdev", "lastbandlow", "lastbandhigh", and "count". Default value is None.
querystringJSON query expression for filtering items. Default value is None.
reprojectstringWarpKernel resampling algorithm (only used when doing re-projection). Defaults to nearest. Known values are: "nearest", "bilinear", "cubic", "cubic_spline", "lanczos", "average", "mode", "max", "min", "med", "q1", "q3", "sum", and "rms". Default value is None.
resamplingstringResampling method. Known values are: "nearest", "bilinear", "cubic", "cubic_spline", "lanczos", "average", "mode", "gauss", and "rms". Default value is None.
return_maskbooleanAdd mask to the output data. Default value is None.
scaleintegerNumeric scale factor for the tile. Higher values produce larger tiles. Default value is None.
scan_limitintegerReturn as soon as we scan N items (defaults to 10000). Default value is None.
sel_methodstringXarray indexing method to use for inexact matches. Known values are: "nearest", "linear", "bilinear", "cubic", "cubic_spline", "lanczos", "area", and "mode". Default value is None.
skipcoveredbooleanSkip any items that would show up completely under the previous items (defaults to True). Default value is None.
sortbystringSorting expression (e.g. +/-property). Default value is None.
subdataset_bandsarrayThe index of a subdataset band within the asset. Default value is None.
subdataset_namestringThe name of a subdataset within the asset. Default value is None.
tile_formatstringDefault will be automatically defined if the output image needs a mask (png) or not (jpeg). Known values are: "png", "npy", "tif", "jpeg", "jpg", "jp2", "webp", and "pngraw". Default value is None.
tile_scaleintegerTile scale factor affecting output size. Values > 1 produce larger tiles (e.g., 1=256x256, 2=512x512). Default value is None.
time_limitintegerReturn after N seconds to avoid long requests (defaults to 5). Default value is None.
trim_endintegerNumber of items to trim from the end of the cmap. Default value is None.
trim_startintegerNumber of items to trim from the start of the cmap. Default value is None.
unscalebooleanApply internal Scale or Offset. Default value is None.
widthintegerWidth in pixels for the output image. Default value is None.

SELECT examples

Searches Assets For Tile Tilematrixsetid As Path. Return a list of assets which overlap a given tile.

SELECT
id,
assets,
bbox,
collection
FROM azure.planetary_computer_dataplane.data
WHERE search_id = '{{ search_id }}' -- required
AND tile_matrix_set_id = '{{ tile_matrix_set_id }}' -- required
AND z = '{{ z }}' -- required
AND x = '{{ x }}' -- required
AND y = '{{ y }}' -- required
AND collection = '{{ collection }}' -- required
AND endpoint = '{{ endpoint }}' -- required
AND scan_limit = '{{ scan_limit }}'
AND items_limit = '{{ items_limit }}'
AND time_limit = '{{ time_limit }}'
AND exitwhenfull = '{{ exitwhenfull }}'
AND skipcovered = '{{ skipcovered }}'
AND subdataset_name = '{{ subdataset_name }}'
AND subdataset_bands = '{{ subdataset_bands }}'
AND crs = '{{ crs }}'
AND datetime = '{{ datetime }}'
AND sel_method = '{{ sel_method }}'
;

Lifecycle Methods

Get ClassMap Legend. Generate values and color swatches mapping for a given classmap.

EXEC azure.planetary_computer_dataplane.data.get_class_map_legend 
@classmap_name='{{ classmap_name }}' --required,
@endpoint='{{ endpoint }}' --required,
@trim_start='{{ trim_start }}',
@trim_end='{{ trim_end }}'
;