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

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

{
    "ob_id": 25417,
    "uuid": "d920cb54fe694711b59379f2b1b1f569",
    "title": "Internal waves density and seabed interaction maps of UK continental shelf (2006-2012)",
    "abstract": "This dataset contains observational frequency maps of internal waves (IW) within the UK Continental Shelf (UKCS) region. The maps were generated by automatic processing of the ENVISAT Advanced Synthetic Aperture Radar (ASAR) data archive covering the period from 2006 to 2012. The IW frequency maps were combined with bathymetry and mixed layer depth modelling data to estimate the interaction of IWs with the sea bed. The results are presented in monthly, seasonal, annual and climatology maps.",
    "keywords": "Internal waves, seabed impact, SAR",
    "publicationState": "citable",
    "dataPublishedTime": "2018-01-03T10:19:50",
    "doiPublishedTime": "2018-01-03T10:52:28.508910",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/25418/?format=api",
        "dataPath": "/badc/deposited2017/wave_density_map/data",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 458774882,
        "numberOfFiles": 3,
        "fileFormat": "Data are NetCDF, tar, GeoTIFF and PNG formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/6880/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1873/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "These data have been sent to the Centre for Environmental Data Analysis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/9362/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/25415/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105637/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105641/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105631/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105634/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105638/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105639/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105640/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105632/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/105633/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/25416/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}