Datasets

  • GET /apps/{app}/datasets/{uuid}/services.json Get dataset description

    Retrieve the dataset service description. This contains information regarding the type of dataset, the services available, and the download options.

    Request Parameters

    Route Parameters
    Parameter Description Type Options
    app Application alias string rgis, epscor, elseweb
    uuid Dataset identifier uuid
    Query Parameters

    None

    Examples

    View the service description for the 2013 Tres Lagunas Post Fire, 10 dataset:

    /apps/rgis/datasets/43db7a5d-67ec-4635-aef6-97131bf390cb/services.json

    Response

    Schema
    id (integer): identifier
    uuid (string): identifier
    name (string): base name
    description (string): title
    availability (boolean): if False, the underlying data is unavailable for download, streaming access or OGC service access.
    lastupdate (date): (yyyyMMdd) date published
    type (string): object type
    taxonomy (string): dataset type (geoimage or vector or file or table)

    "geoimage" refers to a raster dataset.

    categories (array[dict]):
    theme (string): theme (root)
    subtheme (string): subtheme (level 1)
    groupname (string): groupname (level 2)
    downloads (array[dict]):
    {format} (string): URL for the zipped download for the format

    The keys referenced by {format} are the list of supported data formats for this dataset.

    services (array[dict]):
    {service} (string): URL for the OGC service GetCapabilities request

    The keys referenced by {service} are the list of supported OGC services for this dataset (wms, wcs, or wfs).

    metadata (array[dict]):
    {standard} (dict):
    {format} (string): URL for the documentation for the standard and format specified

    The keys referenced by {format} are the list of supported documentation formats for the standard.

    The keys referenced by {standard} are the list of supported documentation standards for this dataset.

    metadata-modified (dict):
    {standard} (date): (yyyy-MM-ddTHH:MM:SSZ) date, in UTC, the source documentation was modified

    The keys referenced by {standard} are the list of supported documentation standards for this dataset. In most cases, this key will be "all" to indicate that the modifications made to the source documentation are reflected in all documentation representations.

    spatial (dict):
    epsg (integer): EPSG code of the original data source
    bbox (array[double]): bounding box in WGS84 as minx, miny, maxx, maxy

    Unless otherwise noted, vector datasets generated by the GSToRE platform are in WGS84 (EPSG:4326). The EPSG code referenced here refers only to the source data (the ZIP format).

    prov (dict):
    ontology (dict):
    traces (dict):
    format (string): URL to provenance trace
    preview (string): URL to the GSToRE-hosted preview request.

    This service will be deprecated shortly.

    Response for a raster dataset:

        {
        "downloads": [{"tif": "http://gstore.unm.edu/apps/epscor/datasets/233adca8-5131-4ca1-aac1-669f6be4c530/treslagunasfire2013_1.original.tif"}],
        "lastupdate": "20140325",
        "uuid": "233adca8-5131-4ca1-aac1-669f6be4c530",
        "taxonomy": "geoimage",
        "description": "2013 Tres Lagunas Post Fire, 1",
        "metadata": [
            {"FGDC-STD-012-2002": {
                "xml": "http://gstore.unm.edu/apps/epscor/datasets/233adca8-5131-4ca1-aac1-669f6be4c530/metadata/FGDC-STD-012-2002.xml",
                "html": "http://gstore.unm.edu/apps/epscor/datasets/233adca8-5131-4ca1-aac1-669f6be4c530/metadata/FGDC-STD-012-2002.html"
            }},
            {"ISO-19115:2003": {
                "xml": "http://gstore.unm.edu/apps/epscor/datasets/233adca8-5131-4ca1-aac1-669f6be4c530/metadata/ISO-19115:2003.xml",
                "html": "http://gstore.unm.edu/apps/epscor/datasets/233adca8-5131-4ca1-aac1-669f6be4c530/metadata/ISO-19115:2003.html"
            }},
            {
                "ISO-19119:WMS": {"xml": "http://gstore.unm.edu/apps/epscor/datasets/233adca8-5131-4ca1-aac1-669f6be4c530/metadata/ISO-19119:WMS.xml"},
                "ISO-19119:WCS": {"xml": "http://gstore.unm.edu/apps/epscor/datasets/233adca8-5131-4ca1-aac1-669f6be4c530/metadata/ISO-19119:WCS.xml"}
            }
        ],
        "metadata-modified": {"all": "2014-03-26T03:56:16Z"},
        "spatial": {
            "epsg": 26913,
            "bbox": [
                -105.719133333,
                35.7587972222,
                -105.697138889,
                35.7738111111
            ]
        },
        "services": [
            {"wms": "http://gstore.unm.edu/apps/epscor/datasets/233adca8-5131-4ca1-aac1-669f6be4c530/services/ogc/wms?SERVICE=wms&REQUEST=GetCapabilities&VERSION=1.1.1"},
            {"wcs": "http://gstore.unm.edu/apps/epscor/datasets/233adca8-5131-4ca1-aac1-669f6be4c530/services/ogc/wcs?SERVICE=wcs&REQUEST=GetCapabilities&VERSION=1.1.2"}
        ],
        "preview": "http://gstore.unm.edu/apps/epscor/datasets/233adca8-5131-4ca1-aac1-669f6be4c530/mapper",
        "type": "dataset",
        "id": 367375,
        "categories": [{
            "subtheme": "2013 Wildfire Data",
            "theme": "Digital Orthophotography",
            "groupname": "Tres Lagunas - Post Fire"
        }],
        "name": "treslagunasfire2013_1"
    }

  • GET /apps/{app}/datasets/{uuid}/dataset.{ext} Streaming dataset request

    This request is only available for vector and table datasets and is limited to text-based outputs, for example CSV or KML.

    Request Parameters

    Route Parameters
    Parameter Description Type Options
    app Application alias string rgis, epscor, elseweb
    uuid Dataset identifier uuid
    ext Data format string CSV, JSON, GeoJSON, KML, GML
    Query Parameters

    Coming soon.

    Examples

    Stream the RGIS dataset SCAN Alcalde, NM (Mar, 2014) as a KML file:

    /apps/rgis/datasets/b6b22969-dfa9-41e5-a836-c483b099c8f7/dataset.kml

    Response

    The structure of the response depends on the format requested, the filters of the request and the structure of the dataset.

  • GET /apps/{app}/datasets/{uuid}/{basename}.{set}.{ext} Download dataset

    Some datasets are hosted on external sites or, if the format is "html", are external sites. In those instances, the request redirects you to the external location. The options available through the query parameters are not available for those datasets, nor are any GSToRE-generated documentation files included with the response.

    Request Parameters

    Route Parameters
    Parameter Description Type Options
    app Application alias string rgis, epscor, elseweb
    uuid Dataset identifier uuid
    basename Dataset name string
    set string original or derived
    ext Data format string any supported format for the dataset
    Query Parameters
    Parameter Description Type Options Required
    ignore-cache Generate a new download boolean F (defaults to False)
    standard Specify a specific documentation standard to be included in the zip file. string F (defaults to the preferred metadata standard of the application specified)
    Examples

    Download the zip file for the GeoTIFF for AZ Barth Well, US Topo 2011 dataset:

    /apps/rgis/datasets/bb5350f9-64ba-4198-8274-eb11f3813955/AZ_Barth_Well_20111125_TM_geo.original.tif

    Download the zip file for the GSToRE-generated KML for NM Gross Receipts January - June 2011 dataset:

    /apps/rgis/datasets/0acbf4fd-d2ab-4216-9c48-803418166003/nmgrossreceipts_jan_jun2011.derived.kml

    Response

    The structure of the response depends on the format requested, the filters of the request and the structure of the dataset.

  • GET /apps/{app}/datasets/{uuid}/metadata/{standard}.{ext} Download dataset documentation

    Download the documentation for the specified dataset.

    GSTORE includes support for FGDC-STD-001-1998 (file or vector) or FGDC-STD-012-2002 (raster), ISO-19115:2003, ISO-19119, and ISO-19110 standards. ISO-19119 is only available for those datasets with web services; ISO-19110 only for vector or tabular datasets. Check the dataset service description for the complete listing of metadata options for a dataset.

    Request Parameters

    Route Parameters
    Parameter Description Type Options
    app Application alias string rgis, epscor, elseweb
    uuid Dataset identifier uuid
    standard Documentation standard string any supported documentation standard
    ext Documentation format string xml or html (not all formats available for all standards)
    Query Parameters

    None

    Examples

    Download the FGDC as XML for the AZ Barth Well, US Topo 2011 dataset:

    /apps/rgis/datasets/bb5350f9-64ba-4198-8274-eb11f3813955/metadata/FGDC-STD-012-2002.xml

    View the ISO 19115 (19139) as HTML for the AZ Barth Well, US Topo 2011 dataset:

    /apps/rgis/datasets/bb5350f9-64ba-4198-8274-eb11f3813955/metadata/ISO-19115:2003.html

    Response

    The structure of the response varies by standard and format.