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

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

{
    "ob_id": 8332,
    "uuid": "c10b78c69887a4960879688e73cb37a0",
    "title": "Data from LANDSAT7 ETMPLUS at Landsat7 for the Landsat Campaign",
    "abstract": "The Landsat 7 program uses the Enhanced Thematic Mapper plus (ETM+) and provides contiguous data from Landsat 1 program from the early 1970's to present (2012).  Landsat data is widely used in many fields including geology, agriculture, resource management, climate analysis etc.  The program is jointly run by the National Aeronautics and Space Administration (NASA) and the US Geological Survey (USGS).  The NERC Earth Observation Data Centre (NEODC) now also holds the data.",
    "keywords": "",
    "publicationState": "published",
    "dataPublishedTime": "2007-05-14T09:21:51",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/8333/?format=api",
        "dataPath": "/neodc/landsat7etm",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1502064611121,
        "numberOfFiles": 39595,
        "fileFormat": "&lt;div property=\"cedacat:formats\"&gt;\n&lt;div class=\"formats\"&gt;Data availability and file format&lt;/div&gt;\n\n&lt;p&gt;NEODC archive&lt;/p&gt;\n&lt;p&gt;Click &lt;a href=\"http://www.neodc.rl.ac.uk/datasearch/index.php?platform_type=satellite\" target=\"_blank\"&gt;here&lt;/a&gt; to search NEODC holdings of Landsat 7 data, or use the &lt;a href=\"http://www.neodc.rl.ac.uk/maps/mapserver_neodc/dbox/neodc/neodc_coverage.html\"&gt;Interactive Map&lt;/a&gt;. Some of these data are available via a &lt;a href=\"http://ignis.neodc.rl.ac.uk/cgi-infrastructure/data_browser/data_browser/neodc/landsat7etm\"&gt;self-service download system&lt;/a&gt; to registered users who have requested access to this dataset. Click &lt;a href=\"http://ignis.neodc.rl.ac.uk/cgi-infrastructure/dataset_registration/dataset_info.cgi.pl?datasetid=landsat7etm\"&gt;here&lt;/a&gt; to request access to this dataset.&lt;/p&gt; \n\n&lt;p&gt;The original data producer's archive is available here: &lt;a href=\"http://edcsns17.cr.usgs.gov/EarthExplorer/\"&gt;USGS Eros Data Centre&lt;/a&gt;&lt;/p&gt;\n&lt;p&gt;Other suppliers:&lt;/p&gt;\n\n&lt;ul&gt;\n&lt;li&gt;&lt;a href=\"http://www.infoterra-global.com\"&gt;Infoterra&lt;/a&gt;&lt;/li&gt; \n&lt;li&gt;&lt;a href=\"http://www.eurimage.com\"&gt;Eurimage&lt;/a&gt;&lt;/li&gt;\n&lt;li&gt;&lt;a href=\"http://www.npagroup.com\"&gt;NPA Group&lt;/a&gt;&lt;/li&gt;\n&lt;/ul&gt;\n&lt;/div&gt;\n\n\n"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/2380/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/5345/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/8334/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/8331/?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/33364/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33363/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33366/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33367/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33369/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33368/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33370/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33365/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/8337/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2635/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "landsat7etm",
            "label": "restricted: landsat7etm group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/landsat7etm_conditions.pdf",
            "licenceClassifications": "academic"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}