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

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

{
    "ob_id": 34729,
    "uuid": "3aaaaf94813e48f18f2b83242a8dacbe",
    "title": "ESA Fire Climate Change Initiative (Fire_cci): Sentinel-3 SYN Burned Area Grid product, version 1.0",
    "abstract": "The ESA Fire Disturbance Climate Change Initiative (CCI) project has produced maps of global burned area derived from satellite observations. The Sentinel-3 SYN Fire_cci v1.0 grid product described here contains gridded data on global burned area derived from surface reflectance data from the OLCI and SLSTR instruments (combined as the Synergy (SYN) product) onboard the Sentinel-3 A&B satellites, complemented by VIIRS thermal information. This product, called FireCCIS310 for short, is currently available for 2019, but it is foreseen to be extended for additional years.\r\n\r\nThis gridded dataset has been derived from the FireCCIS310 pixel product (also available) 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. Information on burned area is included in 22 individual quantities: sum of burned area, standard error, fraction of burnable area, fraction of observed area, and the burned area for 18 land cover classes, as defined by the Copernicus Climate Change Initiative(C3S) Land Cover v2.1.1 product. For further information on the product and its format see the Product User Guide in the linked documentation.",
    "keywords": "ESA, CCI, Grid, Burned Area, Fire Disturbance, Climate Change, GCOS",
    "publicationState": "citable",
    "dataPublishedTime": "2022-04-19T15:17:55",
    "doiPublishedTime": "2022-04-19T15:18:55",
    "updateFrequency": "asNeeded",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/37144/?format=api",
        "dataPath": "/neodc/esacci/fire/data/burned_area/Sentinel3_SYN/grid/v1.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 25977800,
        "numberOfFiles": 13,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10263/?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/8143/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/8144/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12066/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/27599/?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/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.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12077/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12111/?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/169080/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169081/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169082/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169083/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169084/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169085/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/177539/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/177551/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/177552/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/177553/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/177554/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/177555/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/177556/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/177557/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/37148/?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"
        }
    ]
}