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

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

{
    "ob_id": 8339,
    "uuid": "9de2a7566f88ce68250f6a9dae02df5b",
    "title": "MEdium Resolution Imaging Spectrometer (MERIS): Level 1B reprocessed radiance product",
    "abstract": "The Medium Resolution Imaging Spectrometer (MERIS) is one of the ten instruments on board the Envisat satellite launched on the 28th of February 2002 from Kourou (French Guyana) and operated by the European Space Agency (ESA). MERIS is a 68.5 deg field-of-view nadir-pointing imaging spectrometer which measures the solar radiation reflected by the Earth in 15 spectral bands (visible and near-infrared). It obtains a global coverage of the Earth in 3 days. Its main objective is to measure the sea colour and quantify the ocean chlorophyll content and sediment, thus providing information on the ocean carbon cycle and thermal regime. It is also used to derive the cloud top height, cloud optical thickness, aerosol and water vapour column. The ground spatial resolution of the instrument is 260 m x 290 m. Only reduced resolution data (1.04 km x 1.16 km) are archived at the NEODC.\r\n\r\nThis dataset contains Level 1B reprocessed radiances MERIS product.",
    "keywords": "MERIS, Global Radiances, Sea Colour, Ocean Chlorophyll Content, Sediment, Cloud Parameters",
    "publicationState": "published",
    "dataPublishedTime": "2007-02-13T13:40:20",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/8340/?format=api",
        "dataPath": "/neodc/meris/data/l1b/reprocessed",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 8568413439552,
        "numberOfFiles": 20266,
        "fileFormat": "Data are Envisat PDS formatted.\r\n\r\n"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/2381/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22345/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22346/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23084/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23420/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25397/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25844/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25845/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25846/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25853/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25855/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25879/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25885/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25902/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25913/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25922/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25930/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25936/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25983/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25985/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25994/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26107/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26117/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26118/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26119/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26120/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26121/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26122/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26123/?format=api"
    ],
    "dataLineage": "Data acquired directly from European Space Agency (ESA) via a number of routes: File Transfer Protocol (FTP), Linear Tape-Open (LTO) tape transfer and Data Dissemination Service (DDS) link.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/5350/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/8341/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/8338/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30129/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33380/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33381/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33382/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33384/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33385/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33386/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33387/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33383/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/19914/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2554/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "meris",
            "label": "restricted: meris group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/meris.pdf",
            "licenceClassifications": "unstated, specific, academic"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}