Skip to content

Commit

Permalink
Merge pull request #106 from archaeogeek/dev-agi
Browse files Browse the repository at this point in the history 
Adding some pages that were previously missing
  • Loading branch information
@archaeogeek
archaeogeek authored Aug 24, 2023
2 parents 7f58054 + 4ca6082 commit c5d38c6
Show file tree
Hide file tree
Showing 4 changed files with 321 additions and 0 deletions.
97 changes: 97 additions & 0 deletions docs/1037-uk-gemini-introduction.asciidoc
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,97 @@
= UK-GEMINI Introduction
include::./includes/attributes.asciidoc[]

This page describes the requirements and guidance for metadata
conforming to the UK standard known as UK GEMINI. There are several
entry points to the guidance:

* link:1062-gemini-datasets-and-data-series[GEMINI
for datasets and series]
* link:1063-gemini-services[GEMINI for
services]
* Other material
** link:1052-metadata-guidelines-for-geospatial-data-resources-part-1.html[General
introduction to metadata for geographic information]
** link:1051-uk-gemini-v2-2-specification-for-discovery-metadata-for-geospatial-resources.html[General
introduction to GEMINI]
** link:1049-metadata-guidelines-for-geospatial-data-resources-part-2.html[General
guidance for GEMINI]
** link:048-uk-gemini-encoding-guidance.html[General
guidance on the XML encoding of GEMINI]
** https://github.com/AGIGemini/Schematron[Schematron rules for
validating GEMINI records (GitHub link)]
** link:40-gemini/1056-glossary.html[Glossary of terms]
** link:1047-metadata-guidelines-for-geospatial-data-resources-part-3.html[List
of references]
** link:053-common-metadata-errors-uk-location-discovery-metadata-service.html[Common
errors]
Conformance to GEMINI should ensure conformance to the INSPIRE
Implementing Rules. UK specific guidance is provided. If you're
thinking, why GEMINI? Why not just use the INSPIRE Metadata guidance or
the ISO standards?{nbsp}https://www.agi.org.uk/why-uk-gemini/[Click here for
some
reasons.]{nbsp}The{nbsp}https://www.gov.uk/government/publications/recommended-open-standards-for-government/using-metadata-to-describe-data-shared-within-government[UK
Government Digital Service recommends using GEMINI when describing
geographic data]{nbsp}and it is the preferred way to catalogue geographic
data and services at Data.gov.uk.

Both UK GEMINI and the INSPIRE Technical Guidance have been developed
from the International
Standard{nbsp}http://www.iso.org/iso/catalogue_detail?csnumber=26020[ISO
19115:2003]{nbsp}Geographic information - Metadata, with supplementary
material from ISO 19119:2005 Geographic information - Services. The XML
encoding follows ISO 19139:2007 Geographic information - Metadata - XML
encoding. This means that a GEMINI record is widely understood by
geospatial software and users internationally.

Note that GEMINI (and the INSPIRE Guidance) are about metadata for
datasets, series, and services (collectively, 'resources'); not
everything in a GEMINI record can be assumed to be true individually for
each feature instance in the resource. The underlying ISO standards
(19115, 19139) do allow for metadata at the instance level, so the
elements could be used to describe metadata for that, but the guidance
here may not be appropriate and the resulting record could not be
validated as a GEMINI (or INSPIRE) record.

Here is
a{nbsp}link:055-uk-gemini-major-changes-since-1-0.html[summary
of changes]{nbsp}from earlier versions.

Here is
a{nbsp}link:1250-element-summary.html/[summary]{nbsp}of
the GEMINI elements (similar to Table 1 and Table 2 in GEMINI 2.2).

Note: in GEMINI 2.3, the GEMINI Element number is called "GEMINI id";
the actual numbers have not changed, where the same element was in
GEMINI 2.2.

== Software that implements GEMINI 2.3

Several software implementations exist and are in use across the UK:

* https://locationmde.data.gov.uk/[UK Location Metadata Editor]: online
editor owned by the Defra INSPIRE team
* https://geonetwork-opensource.org/[GeoNetwork Open
Source]{nbsp}-{nbsp}https://github.com/AstunTechnology/iso19139.gemini23[GEMINI
plugin]: server software in use in several government departments
* https://www.medin.org.uk/data/submit-metadata[MEDIN metadata editors]:
online and downloadable client editors for the MEDIN community profile

== Feedback

We realise that various aspects of the website could be improved and
that there may be some errors and inconsistencies in the content,
therefore we would like to hear from you if you spot any of these or you
would like to see improvements in terms of presentation and usability.

Please send any comments
to{nbsp}mailto:[email protected]?subject=GEMINI2.3%20feedback[[email protected]]

_Last updated: June 2021_

http://creativecommons.org/licenses/by/4.0/[image:https://i.creativecommons.org/l/by/4.0/88x31.png[Creative
Commons Licence]] +
This work is licensed under
a{nbsp}http://creativecommons.org/licenses/by/4.0/[Creative Commons
Attribution 4.0 International License]
33 changes: 33 additions & 0 deletions docs/1040-checklist-for-conformity.asciidoc
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
= Checklist for Conformity
include::./includes/attributes.asciidoc[]

Return
to link:1037-uk-gemini-standard-and-inspire-implementing-rules.html[GEMINI
2.3 home page]

Metadata for a data resource shall be conformant with UK GEMINI if:

{empty}1. It contains entries for all the mandatory metadata elements as
defined in this Standard;

{empty}2. It contains entries for all those conditional elements where
the condition for inclusion holds;

{empty}3. Each element included in the metadata contains a valid value
from the prescribed domain;

{empty}4. The number of occurrences of each element does not exceed the
maximum number specified;

{empty}5. Each entry is in the prescribed format;

{empty}6. The metadata represents the state of the data resource on the
specified date.

_Last updated: December 2012_

http://creativecommons.org/licenses/by/4.0/[image:https://i.creativecommons.org/l/by/4.0/88x31.png[Creative
Commons Licence]] +
This work is licensed under
a{nbsp}http://creativecommons.org/licenses/by/4.0/[Creative Commons
Attribution 4.0 International License]
80 changes: 80 additions & 0 deletions docs/1047-metadata-guidelines-for-geospatial-data-resources-part-3.asciidoc
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
= Metadata Guidelines for Geospatial Data Resources Part 3
include::./includes/attributes.asciidoc[]

Return
to link:1037-uk-gemini-standard-and-inspire-implementing-rules.html[GEMINI
2.3 home page]

[%header,cols="1,.^9"]
|===
|Reference Number |Author, Title, Version, Date of publication

| 1|AGI,
link:40-gemini/1052-metadata-guidelines-for-geospatial-data-resources-part-1.html[Metadata
Guidelines for Geospatial Data Resources – Part 1, Introduction],
September 2010
| 2|AGI,
link:1049-metadata-guidelines-for-geospatial-data-resources-part-2.html[Metadata
Guidelines for Geospatial Data Resources - Part 2, Creating metadata
using UK GEMINI2 (v2.1)], April 2015
| 3|AGI,
https://www.agi.org.uk/wp-content/uploads/2020/12/METADATAGUIDELINESPART32015-04.pdf[Metadata
Guidelines for Geospatial Data Resources in the UK Part 3 – Metadata
quality] , April 2015
| 4|AGI,
https://www.agi.org.uk/wp-content/uploads/2020/12/GEMINI2.2.pdf[UK
GEMINI, Specification for discovery metadata for geospatial data
resources, v2.2], December 2012
| 5|W3C, http://www.w3.org/TR/xml-c14n[Canonical XML, Version 1.1], May 2008
| 6|EC, https://inspire.ec.europa.eu/network-services/[Commission Regulation (EC) No 976/2009 of 19 October 2009
implementing Directive 2007/2/EC of the European Parliament and of the
Council as regards the
Network Services], October 2009
| 7|EC, http://inspire.ec.europa.eu/metadata[Commission Regulation (EC) No. 1205/2008 of 3 December 2008
Implementing Directive 2007/2/EC of the European Parliament and of the
Council as regards metadata], December 2008
| 8|EC, http://inspire.ec.europa.eu/inspire-legislation/[Directive 2007/2/EC of the European Parliament and of the
Council of 14 March 2007 establishing an Infrastructure for Spatial
Information in the European Community (INSPIRE)], March 2007
| 9|EC, http://inspire.ec.europa.eu/id/document/tg/metadata-iso19139/2.0[Technical Guidance for implementing dataset and service
metadata based on ISO/TS 19139:2007 (Version 2.0.1), INSPIRE Maintenance and Implementation Group
(MIG)], March 2017
|10|e-Government Metadata Standard (e-GMS). Cabinet Office e-Government
Unit. (see http://www.gov.uk/government/organisations/cabinet-office, suggest https://cdn.nationalarchives.gov.uk/documents/information-management/egms-metadata-standard.pdf)
|11|Elliotte Rusty Harold and W. Scott Means, XML in a Nutshell,
Second Edition, June 2002
|12|EPSG, http://www.epsg-registry.org/[Geodetic Parameter Registry, Version
7.5.6]
|13|Federal Geographic Data Committee, http://www.fgdc.gov/standards/standards_publications[Content Standard for Digital
Geospatial Metadata, Version 2], 1998
|14|EU, http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=CELEX:32008R1205:EN:NOT[Commission Regulation (EC) No 1205/2008 of 3 December 2008 implementing Directive 2007/2/EC of the European Parliament and of the Council as regards metadata], December 2008
|15|ESD, http://id.esd.org.uk/list/subjects[Integrated Public Sector Vocabulary (IPSV)]
|16|EC, https://inspire.ec.europa.eu/documents/technical-guidance-implementation-inspire-view-services-1[Technical Guidance for the implementation of INSPIRE View
Services, Version 3.11], April 2013
|17|ISO (and national standards bodies), https://www.iso.org/standard/37629.html[ISO 15836: 2003 Dublin Core metadata element set], November 2003
|18|ISO (and national standards bodies), https://www.iso.org/standard/26020.html[ISO 19115:2003 Geographic information – Metadata], May 2003
|19|ISO (and national standards bodies), https://www.iso.org/standard/32557.html[ISO 19139:2007 Geographic information – Metadata – XML schema
implementation], April 2007
|20|ISO (and national standards bodies), https://www.iso.org/standard/20115.html[ISO 8402:1994 Quality management and quality assurance - Vocabulary], March 1994
|21|ISO (and national standards bodies), https://www.iso.org/standard/40874.html[ISO 8601:2004 Data elements and interchange formats – Information interchange – Representation of dates and times], December 2012
|22|Ordnance Survey, https://data.ordnancesurvey.co.uk/[Ordnance Survey Linked Data Platform]
|23|AGI, https://www.agi.org.uk/wp-content/uploads/2020/11/GEMINI2.2.pdf[UK GEMINI2 Standard Version 2.2], August 2010
|24|UK Location, link:1054-operational-guide.html[Discovery Metadata Service, Operational Guide], Edition 2-2, February 2013
|25|UK Location, https://data.gov.uk/sites/default/files/Coordinate Reference Systems for UK Location - INSPIRE View Servicev1.1_10.pdf[Coordinate Reference Systems for UK Location], December 2012
|26|UK Location, https://data.gov.uk/sites/default/files/DMS%20Operational%20Guide%202-2_10.pdf[Discovery Metadata Service Collection Interface
Specification], February 2013
|27|UK Location, https://data.gov.uk/location/guidance_and_tools[Getting started - series of guides]
|28|UK Location, https://data.gov.uk/sites/default/files/UK%20GEMINI%20Encoding%20Guidance%201.4_10.pdf[UK
GEMINI Encoding Guidance, Version 1.4], February 2013
|29|UK Location, http://data.gov.uk/library/uk-gemini-schematron-schema-technical-guidance[UK GEMINI Schematron Schema Guidance], January 2013
|30|UK Location, UK GEMINI Schematron Schema Version 1.3, January 2013
|31|UK Location, User Guide: Administrators and Editors
|===

_Last updated: February 2018_

http://creativecommons.org/licenses/by/4.0/[image:https://i.creativecommons.org/l/by/4.0/88x31.png[Creative
Commons Licence]] +
This work is licensed under
a{nbsp}http://creativecommons.org/licenses/by/4.0/[Creative Commons
Attribution 4.0 International License]
111 changes: 111 additions & 0 deletions docs/1050-inspire-metadata-requirements.asciidoc
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,111 @@
= INSPIRE Metadata Requirements
include::./includes/attributes.asciidoc[]

The INSPIRE Implementing Rules for Metadata requires that a set of
metadata elements shall be provided. These are grouped in the following
categories:

. Identification
. Classification of spatial and data services
. Keyword
. Geographic location
. Temporal reference
. Quality and validity
. Conformity
. Constraint related to access and use
. Organisations responsible for the establishment, management,
maintenance and distribution of the resource
. Metadata on metadata

These are realized as a set of elements shown below. These may be
implemented in various ways including ISO 19115 and Dublin Core. UK
GEMINI is an ISO 19115 implementation.

[width="100%",cols="20%,20%,20%,20%,20%",]
|===
|*  Metadata category* |*INSPIRE Reference* |*  Metadata element*
|*Multiplicity^†^* |*  Condition (where applicable)*

|Identification |1.1 |Resource title |1 |

| |1.2 |Resource abstract |1 |

| |1.3 |Resource type |1 |

| |1.4 |Resource locator |0..* |Mandatory if a URL is available to
obtain more information on the resource, and/or access related services,
or if linkage to the service is available

| |1.5 |Unique resource identifier |1..* |Not required for services

| |1.6 |Coupled resource |0..* |Only for services, where it is mandatory
if linkage to data sets on which the service operates are available

| |1.7 |Resource language |0..* |Mandatory if the resource includes
textual information. Not required for services

|Classification of spatial and data services |2.1 |Topic category |1..*
|Not required for services

| |2.2 |Spatial data service type |1 |Only for services

|Keyword |3.1 |Keyword value |1..* |

| |3.2 |Originating controlled vocabulary |0..* |Where a vocabulary is
used as the source of the keywords

|Geographic location |4.1 |Geographic bounding box |1..* |Mandatory for
datasets and dataset series, and for services with an explicit
geographic extent

|Temporal reference |5.1 |Temporal extent |1..* |At least one of these
must be given.

| | 5.2 |Date of publication | |

| | 5.3 |Date of last revision | |

| | 5.4 |Date of creation | |

|Quality and validity |6.1 |Lineage |1 |Not required for services

| |6.2 |Spatial resolution |0..* |Mandatory for datasets and dataset
series if an equivalent scale or a resolution distance can be specified,
and for services where there is a restriction on the spatial resolution
for the service.

|Conformity |7.1 |Specification |1..* |

| | 7.2 |Degree |1..* |

|Constraint related to access and use |8.1 |Conditions applying to
access and use |1..* |

| |8.2 |Limitations on public access |1..* |

|Organisations responsible for the establishment, management,
maintenance and distribution of the resource |9.1 |Responsible party
|1..* |

| | 9.2 |Responsible party role |1..* |

|Metadata on metadata |10.1 |Metadata point of contact |1..* |

| |10.2 |Metadata date |1 |

| |10.3 |Metadata language |1 |

a|
Notes

**^† ^**1 indicates mandatory, single valued, 1 ..* indicates mandatory,
multi-valued, 0..* indicates optional multi-valued

| | | |
|===

http://creativecommons.org/licenses/by/4.0/[image:https://i.creativecommons.org/l/by/4.0/88x31.png[Creative
Commons Licence]] +
This work is licensed under
a{nbsp}http://creativecommons.org/licenses/by/4.0/[Creative Commons
Attribution 4.0 International License]

0 comments on commit c5d38c6

Please sign in to comment.