MAGIC Discovery (v1)

About

Notes

Rational

The base ISO 19115 requirements are very minimal and not sufficient to meet MAGIC's needs, including:

• ensuring records comply with the BAS Data Catalogue Record Requirements
• ensuring Esri item metadata (internal URL) can be derived from records, to prevent inconsistency and repeated effort
• ensuring access and usage constraints are captured, as MAGIC routinely handles sensitive and licensed information
• ensuring minimal information is available to enable future editing workflows (progress and status)
• ensuring a minimal level of data quality information is captured (lineage information)

In essence, this profile aims to provide a higher floor for record completeness, to ensure a minimal level of utility.

Base standard

This profile is based on:

• the ISO 19115-2:2009 standard
• the BAS Data Catalogue Record Requirements

Definition

Abstract (this document)

JSON Schema

Example records

Minimal resource record (product): JSON | XML

Minimal container record (collection): JSON | XML

Requirements

Overview

Requirement 01 - File Identifier

Records MUST include the file identifier element, using a value that MUST be unique across all records.

Requirement 02 - Domain Consistency

Records MUST include a domain consistency data quality element, stating the record complies with this profile.

The element value MUST be as per Appendix 1 - Data Consistency Element.

Requirement 3 - Hierarchy Level

Records MUST include the hierarchy level element.

The element value MUST be one of these allowed options:

• 'collection'
• 'dataset'
• 'product'
• 'paperMapProduct'
• 'series'

Requirement 4 - Catalogue Identifier

Records MUST include an identifier element, identifying the resource within the BAS Data Catalogue.

The identifier MUST use these values:

Requirement 5 - Edition

Records MUST include an edition within the resource citation element, using a value that MUST be unique across all editions of the resource.

Requirement 6 - Released Date

Published resources MUST include a released date within the resource citation element of the record.

The released date value MAY be in the past (in which case the resource is deemed 'released'), or the future (and deemed 'under embargo').

Draft records MAY include a released date if desired.

Requirement 7 - Publication Date

Published resources MUST include a publication date with a value in the past, within the resource citation element of the record.

Draft records MAY include a publication date with a value in the future (i.e. if the publication date is known). They MUST NOT use a date in the past, as they will not be considered as draft.

Requirement 8 - Point of Contact

Records MUST include MAGIC as a contact using the 'Point of Contact' role, within the resource citation element.

Requirement 9 - Access Constraints

Records MUST include an access constraint, indicating who can access the resource.

Requirement 10 - Usage Constraints

Records MUST include a usage constraint, indicating the licence under which the resource can be used.

Requirement 11 - Progress Code

Records MUST include a progress code for both the resource and record, using a value from the 'ISO 19115 MD_ProgressCode' code list.

Requirement 12 - Update Frequency Code

Records MUST include an update frequency code for both the resource and record, using a value from the 'ISO 19115 MD_MaintenanceFrequencyCode' code list.

Requirement 13 - Lineage Statement

Non-collection records MUST include a lineage statement element describing the origins and sources used to create the resource.

Collection records MAY include this element if desired.

Requirement 14 - Geographic Extent

Records MUST include a bounding box element defining the geographic extent of the resource, with an extent identifier of 'bounding'.

Records MAY include additional extents (with geographic and/or temporal and/or vertical components) as desired.

Appendices

Appendix 1 - Domain Consistency Element

{
  "identification": {
    "domain_consistency": [
      {
        "specification": {
          "title": {
            "value": "British Antarctic Survey (BAS) Mapping and Geographic Information Centre (MAGIC) Discovery Metadata Profile",
            "href": "https://metadata-standards.data.bas.ac.uk/profiles/magic-discovery/v1/"
          },
          "dates": {
            "publication": "2024-11-01"
          },
          "edition": "1",
          "contact": {
            "organisation": {
              "name": "Mapping and Geographic Information Centre, British Antarctic Survey",
              "href": "https://ror.org/01rhff309",
              "title": "ror"
            },
            "phone": "+44 (0)1223 221400",
            "address": {
              "delivery_point": "British Antarctic Survey, High Cross, Madingley Road",
              "city": "Cambridge",
              "administrative_area": "Cambridgeshire",
              "postal_code": "CB3 0ET",
              "country": "United Kingdom"
            },
            "email": "magic@bas.ac.uk",
            "online_resource": {
              "href": "https://www.bas.ac.uk/teams/magic",
              "title": "Mapping and Geographic Information Centre (MAGIC) - BAS public website",
              "description": "General information about the BAS Mapping and Geographic Information Centre (MAGIC) from the British Antarctic Survey (BAS) public website.",
              "function": "information"
            },
            "role": [
              "publisher"
            ]
          }
        },
        "explanation": "Resource within scope of British Antarctic Survey (BAS) Mapping and Geographic Information Centre (MAGIC) Discovery Metadata Profile.",
        "result": true
      }
    ]
  }
}

Appendix 2 - MAGIC Point of Contact Element

{
  "organisation": {
    "name": "Mapping and Geographic Information Centre, British Antarctic Survey",
    "href": "https://ror.org/01rhff309",
    "title": "ror"
  },
  "phone": "+44 (0)1223 221400",
  "address": {
    "delivery_point": "British Antarctic Survey, High Cross, Madingley Road",
    "city": "Cambridge",
    "administrative_area": "Cambridgeshire",
    "postal_code": "CB3 0ET",
    "country": "United Kingdom"
  },
  "email": "magic@bas.ac.uk",
  "online_resource": {
    "href": "https://www.bas.ac.uk/teams/magic",
    "title": "Mapping and Geographic Information Centre (MAGIC) - BAS public website",
    "description": "General information about the BAS Mapping and Geographic Information Centre (MAGIC) from the British Antarctic Survey (BAS) public website.",
    "function": "information"
  },
  "role": [
    "pointOfContact"
  ]
}