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

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

{
    "ob_id": 27798,
    "uuid": "fa199424852d49f4ba85afddd850eae6",
    "title": "ESA Ocean Colour Climate Change Initiative (Ocean_Colour_cci): Global chlorophyll-a data products gridded on a sinusoidal projection, Version 4.0",
    "abstract": "The ESA Ocean Colour CCI project has produced global level 3 binned multi-sensor time-series of satellite ocean-colour data with a particular focus for use in climate studies.\r\n\r\nThis dataset contains their Version 4.0 chlorophyll-a product (in mg/m3) on a sinusoidal projection at 4 km spatial resolution and at a number of time resolutions (daily, 5-day, 8-day and monthly composites).   Note, the chlorophyll-a data are also included in the 'All Products' dataset. \r\n\r\nThis data product is on a sinusoidal equal-area grid projection, matching the NASA standard level 3 binned projection. The default number of latitude rows is 4320, which results in a vertical bin cell size of approximately 4 km. The number of longitude columns varies according to the latitude, which permits the equal area property. Unlike the NASA format, where the bin cells that do not contain any data are omitted, the CCI format retains all cells and simply marks empty cells with a NetCDF fill value. (A separate dataset is also available for data on a geographic projection.)\r\n\r\nPlease note, this dataset has been superseded. Later versions of the data are now available.",
    "keywords": "ESA, CCI, Ocean Colour, Sinusoidal, chlorophyll-a",
    "publicationState": "published",
    "dataPublishedTime": "2019-11-27T16:21:02",
    "doiPublishedTime": null,
    "updateFrequency": "asNeeded",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/28039/?format=api",
        "dataPath": "/neodc/esacci/ocean_colour/data/v4.0-release/sinusoidal/netcdf/chlor_a/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1255478829897,
        "numberOfFiles": 10564,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7533/?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/12066/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50512/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52664/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52665/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55890/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55897/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55904/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55905/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55907/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59891/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59892/?format=api"
    ],
    "dataLineage": "These data were produced by the ESA Ocean Colour CCI project and provided to CEDA in the context of the ESA CCI Open Data Portal project.\r\nThis dataset forms part of the v4.0 ocean colour dataset collection that can be cited with the following doi:  10.5285/00b5fc99f9384782976a4453b0148f49",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13365/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/27791/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30128/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116279/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116280/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116281/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116284/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116285/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116282/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193380/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193381/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116287/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118083/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118084/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118085/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118086/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118087/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118088/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118089/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118090/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118091/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118092/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118093/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118094/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118095/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118096/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118097/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118098/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118099/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118100/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118101/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118102/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118103/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118104/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118105/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118106/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118107/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118108/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118109/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118110/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/118111/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/28111/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2538/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_oc_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}