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

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

{
    "ob_id": 46098,
    "uuid": "8cd69bd991a942a3828bd7b24d039ad7",
    "title": "EOCIS: Daily land surface temperature from Landsat 8/9, level 2 merged (L2) UK product, version 1.00",
    "abstract": "This dataset contains land surface temperatures (LSTs) and their uncertainty estimates from the Thermal Infrared Sensor (TIRS) on Landsat 8/9. Satellite land surface temperatures are skin temperatures, which means, for example, the temperature of the ground surface in bare soil areas, the temperature of the canopy over forests, and a mix of the soil and leaf temperature over sparse vegetation. The skin temperature is an important variable when considering surface fluxes of, for instance, heat and water.\r\n\r\nDaytime temperature estimates are provided at approximately 10:30 local solar time. Temperatures are reported in Kelvin and represent the skin temperature of the Earth's surface.\r\n\r\n\r\nThe dataset was produced by the University of Leicester (UoL) and LSTs were retrieved using the (UoL) LST retrieval algorithm and data were processed in the UoL processing chain.\r\n\r\nThe dataset was produced as part of the UK Earth Observation Climate Information Service (EOCIS) and is based on development funded under ESA CCI with additional funding from NCEO.  The EOCIS dataset includes and continues the CCI v4 CDR (currently under development).",
    "keywords": "land surface temperature, EOCIS, Landsat",
    "publicationState": "preview",
    "dataPublishedTime": null,
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://catalogue.ceda.ac.uk/api/v2/observations/46150/?format=api",
        "dataPath": "/neodc/eocis/data/CHUK/land_surface_temperature/LANDSAT8_TIRS/L2/v1.0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 7366618967,
        "numberOfFiles": 1827,
        "fileFormat": "These data are in netCDF format."
    },
    "timePeriod": "https://catalogue.ceda.ac.uk/api/v2/times/13264/?format=api",
    "geographicExtent": "https://catalogue.ceda.ac.uk/api/v2/bboxes/2609/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/46768/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/74919/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/74920/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/74921/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/74922/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/phenomona/102917/?format=api"
    ],
    "dataLineage": "The data record has been produced by the University of Leicester as part of the UK Earth Observation Climate Information Service (EOCIS) project and is based on development funded under ESA CCI with additional funding from NCEO.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://catalogue.ceda.ac.uk/api/v2/projects/43216/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220197/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220198/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220199/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220200/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220201/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220202/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220203/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220204/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220205/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220206/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220207/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220265/?format=api",
        "https://catalogue.ceda.ac.uk/api/v2/rpis/220208/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://catalogue.ceda.ac.uk/api/v2/composites/46105/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://catalogue.ceda.ac.uk/api/v2/observations/2528/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://creativecommons.org/licenses/by/4.0/",
            "licenceClassifications": "any, attribution required"
        }
    ],
    "discoveryKeywords": []
}