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

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

{
    "ob_id": 26433,
    "uuid": "3628cb2fdba443588155e15dee8e5352",
    "title": "ESA Fire Climate Change Initiative (Fire_cci): MODIS Fire_cci Burned Area Grid product, version 5.1",
    "abstract": "The ESA Fire Disturbance Climate Change Initiative (CCI) project has produced maps of global burned area derived from satellite observations. The MODIS Fire_cci v5.1 grid product described here contains gridded data on global burned area derived from the MODIS instrument onboard the TERRA satellite at 250m resolution for the period 2001 to 2019.  This product supercedes the previously available MODIS v5.0 product. The v5.1 dataset was initially published for 2001-2017, and has later been periodically extended to include 2018 to 2022. \r\n\r\nThis gridded dataset has been derived from the MODIS Fire_cci v5.1 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 23 individual quantities: sum of burned area, standard error, fraction of burnable area, fraction of observed area, number of patches and the burned area for 18 land cover classes, as defined by the Land_Cover_cci v2.0.7  product. For further information on the product and its format see the Fire_cci product user guide in the linked documentation.",
    "keywords": "ESA, CCI, GRID, Burned Area, Fire Disturbance, Climate Change, GCOS Essential Climate Variable",
    "publicationState": "citable",
    "dataPublishedTime": "2019-02-08T14:49:28",
    "doiPublishedTime": "2019-02-08T14:51:49",
    "updateFrequency": "unknown",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/26985/?format=api",
        "dataPath": "/neodc/esacci/fire/data/burned_area/MODIS/grid/v5.1/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 23711230101,
        "numberOfFiles": 295,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8231/?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 ESA's 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/10216/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10221/?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/110881/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/110882/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/110883/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/110885/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/110910/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/110908/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140427/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/110884/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/110909/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/110886/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/110887/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/110899/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/110891/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/25857/?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"
        }
    ]
}