Observation Instance – Django REST framework

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/26189/?format=api

HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 26189,
    "uuid": "4b0773a84e8142c688a628c9ce62d4ec",
    "title": "ESA Fire Climate Change Initiative (Fire_cci): Small Fire Database (SFD) Burned Area grid product for Sub-Saharan Africa, version 1.1",
    "abstract": "The ESA Fire Disturbance Climate Change Initiative (Fire_cci) project has produced maps of global burned area developed from satellite observations. The Small Fire Database (SFD) pixel products have been obtained by combining spectral information from Sentinel-2 MSI data and thermal information from MODIS MOD14MD Collection 6 active fire products.\r\n\r\nThis gridded dataset has been derived from the Small Fire Database (SFD) Burned Area pixel product for Sub-Saharan Africa, v1.1 (also available), which covers Sub-Saharan Africa for the year 2016, by summarising its burned area information into a regular grid covering the Earth at 0.25 x 0.25 degrees resolution and at monthly temporal resolution.",
    "keywords": "ESA, CCI, Grid, Burned Area, Fire Disturbance, Climate Change, GCOS Essential Climate Variable",
    "publicationState": "citable",
    "dataPublishedTime": "2019-02-08T14:48:44",
    "doiPublishedTime": "2019-02-08T14:51:09",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27005/?format=api",
        "dataPath": "/neodc/esacci/fire/data/burned_area/SFD/Africa/Sentinel2/grid/v1.1/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 555110314,
        "numberOfFiles": 15,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7269/?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/6021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/57314/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/57317/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59231/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59233/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59234/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59235/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59236/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59237/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68093/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68094/?format=api"
    ],
    "dataLineage": "Data was produced by the ESA Fire CCI team as part of the ESA Climate Change Initiative (CCI) and is being held on the CEDA (Centre for Environmental Data Analysis) archive as part of the ESA CCI Open Data Portal project.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10212/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10220/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13255/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/12683/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109630/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109631/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109632/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109629/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109655/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142475/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142476/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109628/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109656/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109646/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109638/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/26618/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2539/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_fire_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        },
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}