Get a list of Observation objects.

### Available end points:

- `/observations/` - Will list all Results in the database
- `/observations.json` - Will return all Results in json format. This can
also be achieved by using the accept header. `application/json`
- `/observations/<object_id>/` - Returns Results object with that id

### Available Methods:

- `GET`
- `HEAD`

### Available filters:

- `title`
- `uuid`
- `keywords`
- `status`
- `result_field`
- `discoveryKeywords`
- `updateFrequency`
- `nonGeographicFlag`
- `publicationState`
- `permissions`

### How to use filters:

These filters can be used like django query filters using __ for related model relationships.

- `/observations/?uuid=d594d53df2612bbd89c2e0e770b5c1a0`
- `/observations/?status=completed`
- `/observations/?results_field__dataPath__startswith=/neodc/esacci`
- `/observations/?discoveryKeywords__name=ESACCI`
- `/observations/?nonGeographicFlag=True`

Filters can be stacked to build an 'AND' relationship. E.g.

- `/observations/?publicationState__in=published,citable&nonGeographicFlag=True`
- `/observations/?publicationState__in=published,citable&discoveryKeyword__name=NDGO0003`

GET /api/v2/observations/27012/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 27012,
    "uuid": "d459cadad5f342e5a673463dce2a9b4e",
    "title": "Global gas flaring activity from the ATSR (1991-2012) and SLSTR (2017-2018) sensors",
    "abstract": "This dataset contains Global gas flaring activity from the Along Track Scanning Radiometer (ATSR) (1991-2012) and Sea and Land Surface Temperature Radiometer (SLSTR) (2017-2018) sensors. The data records have been processed to identify persistent thermal anomalies with spectral characteristics consistent with the combustion of natural gas during industrial gas flaring activities.\r\n\r\nTwo different datasets are produced globally for each sensor type, one recording the activity and the other the sampling of these assumed gas flaring sites.\r\n\r\nThe activity dataset records whenever a flare is up, i.e. is actively combusting, and provides a characterisation of the flares behaviour in terms of radiant heat output (in W). The determination of radiant heat output is achieved using the single channel SWIR radiance method of Fisher and Wooster (2018), based on the MWIR radiance method used extensively in the analysis of biomass burning.\r\n\r\nThe sampling dataset records whenever a flaring site is seen by the satellite (irrespective of whether it is up or not) and also provides information on typical levels of cloud cover in the vicinity of the flare.\r\n\r\nThe activity dataset contains information on the point location of the flare (accurate to within approximately ±1km) in the form of a lat/lon coordinate. Also provided is an index lookup that can be used to simply aggregate the flaring activity into arc-minute bins and these are referred to as lat_arcmin and lon_arcmin in the dataset.\r\n\r\nThe sampling dataset is provided at the spatial level of the arc-minute binning only, and when merged onto the activity dataset long-term assessment of a flaring site can be performed. Such estimates of flaring activity over extended time periods for a given flaring site can be made by calculating the flare up-time (times seen actively flaring over time period or the expected number of cloud free overpasses for time period) and the mean radiant heat output of the flare for the same time period. The product of time period (in seconds), the estimated flare up-time and the mean radiant heat output provides an estimate of typical flare activity.",
    "keywords": "Global gas, ATSR, SLSTR",
    "publicationState": "citable",
    "dataPublishedTime": "2019-08-05T11:02:26",
    "doiPublishedTime": "2019-08-05T12:32:47",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27011/?format=api",
        "dataPath": "/neodc/global_gas_flaring/data/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 2805392493,
        "numberOfFiles": 519,
        "fileFormat": "Data are BADC-CSV formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7272/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83782/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83783/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83784/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83785/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83786/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83787/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83788/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83789/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83790/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83791/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83792/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83793/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83794/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83795/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83796/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83797/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83798/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83799/?format=api"
    ],
    "dataLineage": "This dataset was produced as part of research into further applications of the MWIR Radiance method for the characterisation of thermal anomalies carried out under NERC NCEO funding. The data were then sent to the Centre for Environmental Analysis for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10539/?format=api"
    ],
    "projects": [],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113272/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113273/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113274/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113275/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113277/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113278/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113279/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113276/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115501/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/27610/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}