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

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

{
    "ob_id": 43179,
    "uuid": "593397b5f9654d76b5d37761e7566ca6",
    "title": "ESA Fire Climate Change Initiative (Fire_cci): Long-term Small Fire Dataset (SFDL) Burned Area pixel product for Test Sites: Amazonia, Africa and Siberia, version 1.0",
    "abstract": "The ESA Fire Disturbance Climate Change Initiative (Fire_cci) project aims to generate burned area developed from satellite observations. The Long-Term Small Fire Dataset (SFDL) pixel products have been obtained using spectral information from Landsat sensors for three study areas located in different parts of the world (Amazon, Sahel and Siberia), and coinciding with the ESA CCI High Resolution Land Cover product.\r\n\r\nThe dataset uses surface reflectance information from the Landsat-4 and Landsat-5 TM, Landsat-7 ETM+ and Landsat-8 OLI sensors, and covers the period 1990 to 2019, with a spatial resolution of 0.00025 degrees (approximately 30 m at the Equator).",
    "keywords": "ESA, CCI, Pixel, Burned Area, Fire Disturbance, Climate Change",
    "publicationState": "citable",
    "dataPublishedTime": "2024-12-19T12:14:13",
    "doiPublishedTime": "2024-12-19T13:39:18.607048",
    "updateFrequency": "",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43316/?format=api",
        "dataPath": "/neodc/esacci/fire/data/burned_area/SFDL/v1.0/pixel",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 3707585337793,
        "numberOfFiles": 323998,
        "fileFormat": "geotiff"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11916/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4632/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "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/13214/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13219/?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/205335/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205336/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205337/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205338/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205339/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205340/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205638/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205639/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205640/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205641/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205642/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/43233/?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": 1140,
            "name": "ESACCI"
        }
    ]
}