Proposal 2007-01 : OGC:GetCapabilities harvesting

Date	2007/12/07
Contact(s)	​François Prunayre
Last edited	Timestamp
Status	draft
Assigned to release	Release number, to be determined
Resources	Indicate if the required resources are available to complete the proposal

Overview

Use the OGC:GetCapabilities document to produce metadata for services and layers in ISO19119/139 format

• add metadata of services based on ISO19119 in GeoNetwork.
• add import XML document functionnality using XSLT stylesheet
• add harwest WxS GetCapabilities

Proposal Type

• Type: New functionality
• App: GeoNetwork
• Module: Harvester, Metadata Import

Links

• Documents:
• Email discussions:
  • ​Thread 1
  • ​Thread 2

• Other wiki discussions:

Voting History

• Vote not yet proposed.

Uses cases

• UC1 : Create metadata using copy/paste the GetCapabilities document of a WxS service (i.e. Create a full ISO19119 MD based on a GetCapabilities request)
• UC2 : Harvest metadata from a WxS service (i.e. Create a full ISO19119 MD based on a GetCapabilities request)
• UC3 : Update Bbox section of a dataset metadata based on WMS GetCapabilities info (i.e. Update part of MD based on a Request)

Import GetCapabilities document

Harvest GetCapabilities document

Parameters

• Input parameter : URL of the service for which to create metadata
• Ouput parameter :
  • ISO19119 metadata xml file to be load into GeoNetwork
  • ISO19139 metadata for each layers of the services
  • (optional) thumbnails

GUI

Import

Harvesting

Mapping

Service

OGC Service supported :

• WMS 1.0.0
• WMS 1.1.1
• WCS 1.0.0
• WFS 1.0.0
• WFS 1.1.0

Namespaces :

• xmlns:wfs="http://www.opengis.net/wfs"
• xmlns:ows="http://www.opengis.net/ows"
• xmlns:wcs="http://www.opengis.net/wcs"

Root element:

• WMS = WMT_MS_Capabilities
• WFS = wfs:WFT_MS_Capabilities
• WCS = wcs:WCS_Capabilities

• Service metadata /gmd:MD_Metadata
• Service Identfication /gmd:identificationInfo/srv:SV_ServiceIdentification

Element	ISO19119 equivalent	Service type	GetCapabilities element	Note	Agreement
Service metadata
Identifier	/gmd:fileIdentifier/gco:CharacterString	WFS 1.1.0	wfs:GetCapabilities/wfs:DCPType/wfs:HTTP/wfs:Get/@onlineResource + @version	Service url + version
		WFS 1.0.0	ows:Operation[@name='GetCapabilities']/ows:DCP/ows:HTTP/ows:Get/@xlink:href + @version
		WMS	GetCapabilitiesOnlineResource[1]/@xlink:href + @version
		WCS	wcs:GetCapabilities//wcs:OnlineResource[1]/@xlink:href + @version
Language	/gmd:language/gco:characterString		« eng »	Default value « eng »
CharacterSet	/gmd:CharacterSet/gmd:MD_CharacterSetCode		« utf8 »
Contact	/gmd:contact		cf contact mapping
Date stamp	/gmd:dateStamp/gco:DateTime			Harvesting/Import date
Standard name	/gmd:metadataStandardName/gco:CharacterString		« ISO 19119/2005 »
Standard version	/gmd:metadataStandardVertsion/gco:CharacterString		« 1.0 »
Service Identfication
Title	/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString	WFS 1.1.0	ows:ServiceIdentification/ows:Title
		WFS 1.0.0	wfs:Service/wfs:Title
		WMS	Service/Title
		WCS	wcs:Service/wcs:label
Date	/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:dateTime
Abstract	/gmd:abstract/gco:CharacterString	WFS 1.1.0	ows:ServiceIdentification/ows:Abstract
		WFS 1.0.0	wfs:Service/wfs:Abstract
		WMS	Service/Abstract
		WCS	wcs:Service/wcs:description
Status	/gmd:status/gmd:MD_ProgressCode		« Completed »
Contact	/gmd:pointOfContact		cf contact mapping
Keyword	/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString	WFS 1.1.0	/ows:keywords/ows:Keyword	« theme » for type
		WFS 1.0.0	/wfs:Keywords/wfs:Keywords
		WMS	/KeywordList/Keyword
		WCS	/wcs:keywords/wcs:keyword
Topic Category	/gmd:topicCategory/gmd:MD_TopicCategoryCode			User input
Service type	/srv:serviceType/gco:LocalName codeSpace="www.w3c.org"	WFS 1.1.0	« OGC:WFS »	user input
		WFS 1.0.0	« OGC:WFS »
		WMS	« OGC:WMS »
		WCS	« OGC:WCS »
Service version	/srv:serviceTypeVersion/gco:CharacterString		/ROOT/@version	eg. « 1.0.0 »
Fees	/srv:accessProperties/gmd:MD_StandardOrderProcess/gmd:fees/gco:CharacterString	WFS 1.1.0	/ows:Fees
		WFS 1.0.0	/wfs:Fees
		WMS	/Fees
		WCS	/wcs:Fees
AccessConstraint	/gmd:resourceConstraints/gmd:MD_Constraints/gmd:useLimitation	WFS 1.1.0	/ows:AccessConstraints
		WFS 1.0.0	/wfs:AccessConstraints
		WMS	/AccessConstraints
		WCS	/wcs:AccessConstraints
Operations	/srv:containsOperations/srv:SV_OperationMetadata/srv:operationName/gco:CharacterString	WFS 1.1.0	/ows:OperationsMetadata/*	cf mappin on operation
		WFS 1.0.0	/wfs:Capability/wfs:Request/*
		WMS	/Capability/Request/*
		WCS	/wcs:Capability/wcs:Request/*
OperatesOn	/srv:operatesOn/gmd:MD_DataIdentification/@uuidref	WFS 1.1.0	metadata uuid for generated layer/coverage/featuretype metadata
		WFS 1.0.0
		WMS
		WCS
Bounding box	/srv:SV_ServiceIdentification/srv:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicBoundingBox	WFS 1.1.0	math:min(//ows:WGS84BoundingBox/ows:LowerCorner / UpperCorner)
		WFS 1.0.0	math:min(//wfs:LatLongBoundingBox/@minx)
		WMS	math:min(//LatLonBoundingBox/@minx)
		WCS	math:min(//wcs:lonLatEnvelope/gml:pos[1 / 2])
CRS	referenceSystemInfo/MD_ReferenceSystem/referenceSystemIdentifier/RS_Identifier/code			4326 if available if not the first one
Status	/srv:SV_ServiceIdentification/status/MD_ProgressCode		« completed »

Link between data and service:

<srv:operatesOn>
        <gmd:MD_DataIdentification uuid='identifier'/>
</srv:operatesOn>

Data

		WFS 1.1.0
		WMS
		WCS

Root element:

• WMS = WMT_MS_Capabilities/Capability/Layer
• WFS = wfs:WFS_Capabilities/FeatureTypeList/FeatureType
• WCS = wcs:WCS_Capabilities/ContentMetadata/CoverageOfferingBrief

• Data metadata = /gmd:MD_Metadata
• Layer identification = gmd:identificationInfo/srv:SV_ServiceIdentification
• Distribution = gmd:distributionInfo/gmd:MD_Distribution/gmd:transferOptions/gmd:MD_DigitalTransferOptions/gmd:onLine/gmd:CI_OnlineResource
• Data quality = gmd:dataQualityInfo/gmd:DQ_DataQuality
• Projection = gmd:referenceSystemInfo/gmd:MD_ReferenceSystem/gmd:referenceSystemIdentifier/gmd:RS_Identifie

Element	ISO19115 equivalent	GetCapabilities element	Note
Service metadata
Identifier	/gmd:fileIdentifier/gco:CharacterString	uuid	Problème d'unicité ?
Language	/gmd:language/gco:characterString	« eng »	Par défaut « eng »
CharacterSet	/gmd:CharacterSet/gmd:MD_CharacterSetCode	« utf8 »
Contact	/gmd:contact	cf
Date stamp	/gmd:dateStamp/gco:DateTime		Date et heure de l'import
Standard name	/gmd:metadataStandardName/gco:CharacterString	« ISO 19115:2003/19139 »
Standard version	/gmd:metadataStandardVersion/gco:CharacterString	1
Layer identification
Title	/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString	/ROOTLayer|FeatureType|CoverageOfferingBrief/Title|Description or Label (for WCS)
Date	/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:dateTime
Abstract	/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString	/ROOTLayer|FeatureType|CoverageOfferingBrief/Abstract|Description
LatLonBoundingBox	/gmd:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicBoundingBox/ gmd:westBoundLongitude|gmd:eastBoundLongitude|gmd:southBoundLatitude|gmd:northBoundLatitude/gco:Decimal	/ROOTLayer|FeatureTypeLatLonBoundingBox/@
Status	/gmd:status/gmd:MD_ProgressCode	« Completed »
Contact	/gmd:pointOfContact	cf
Scale	/gmd:spatialResolution/gmd:MD_Resolution/gmd:equivalentScale/gmd:MD_RepresentativeFraction/gmd:denominator/gco:Integer	/ROOTLayer|FeatureType|CoverageOfferingBrief/MinScaleDenominator	MaxScaleDenominator
Projection
	/gmd:code/gco:CharacterString		Code Epsg Format ?
Distribution
URL	/gmd:linkage/gmd:URL	[Root]/Service/OnlineResource
Protocol	/gmd:protocol/gco:CharacterString	TO BE DEFINED	mime-type ou liste GeoNetwork
Name	/gmd:name/gco:CharacterString	/ROOTLayer|FeatureType|CoverageOfferingBrief/Name
Description	/gmd:description/gco:CharacterString	/ROOTLayer|FeatureType|CoverageOfferingBrief/Title|Label
Data Quality
Topic	/gmd:scope/gmd:DQ_Scope/gmd:level/gmd:MD_ScopeCode		« dataset », « featureType » Coverage ?

Contact

Element	ISO19115 equivalent	GetCapabilities element	Note
Name	/gmd:individualName/gco:CharacterString	WMT_MS_Capabilities/Service/contactInformation/ContactPersonPrimary/ContactPerson
Organisation	/gmd:organisationName/gco:CharacterString	WMT_MS_Capabilities/Service/contactInformation/ContactPersonPrimary/ContactOrganization
Role	/gmd:role/gmd:CI_RoleCode	« pointOfContact »
Phone gmd:phone/gmd:CI_Telephone
Voice	/gmd:voice/gco:CharacterString	ContactVoiceTelephone
Fax	/gmd:facsim/gco:CharacterString	ContactFacsimileTelephone
Address gmd:address/gmd:CI_Address
Delivery point	/gmd:deliveryPoint/gco:CharacterString	ContactAddress/Address
Administrative	/gmd:administrativeArea/gco:CharacterString	ContactAddress/StateOrProvince
City	/gmd:city/gco:CharacterString	ContactAddress/City
PostCode	/gmd:postalCode/gco:CharacterString	ContactAddress/PostCode
Country	/gmd:country/gco:CharacterString	ContactAddress/Country
Email	/gmd:electronicMailAddress/gco:CharacterString	email?

Operation

• Identification = /MD_Metadata/srv:SV_ServiceIdentification
• Operation = /MD_Metadata/srv:SV_ServiceIdentification/srv:containsOperations/srv:SV_OperationMetadata/

Element	ISO19119 equivalent	GetCapabilities element	Note
Identification
Coupling type	/srv:couplingType	« tight »
Operation
Name	/srv:operationName/gco:CharacterString	/ROOT/Capability/Request/child::name()
DCP	/srv:DCP/srv/DCPList	/ROOT/DCPType/child::name()
URL	/srv:connectPoint/gmd:CI_OlineRessource/gmd:linkage/gmd:URL	/ROOT/DCPTypeOnlineResource/@xlink:href
Protocol	/srv:connectPoint/gmd:CI_OlineRessource/gmd:protocol/gco:CharacterString		Note : mime-type ? « HTTP GET », « HTTP POST »
Function	/srv:connectPoint/gmd:CI_OlineRessource/gmd:function	« Information »