GeoJSON Encoding Rule for INSPIRE Environmental Monitoring Facilities

Version: 0.2 Date: 2019-08-31

Environmental Monitoring Facilities describe measuring stations, networks and programs, and makes use of Observations & Measurement (OM) data, in many cases using specific observations (OMSO).

The purpose of the this encoding rule is to create a simple structure for the data directly related to the monitoring facility itself so that users can create simple maps with info on measurements station with the actual measures inlined. A typical feature will thus describe one monitoring facility with one measurement result for one given point in time. Since information about the point in time and the result are inlined, tools such as ArcGIS can use this information with the inbuilt time series visualisation tools as well.

An additional objective is to provide an efficient structure for the measurements made by a monitoring facility. This is achieved by building on the rules defined in the OMSF GeoJSON encoding.

This encoding rule can be used as an alternative encoding for Environmental Monitoring Facility data that fulfills the following requirements:

Only one legal background document needs to be referenced
The measurements are of the following types: Simple result, PointObservation, PointTimeSeriesObservation, MultiPointObservation, ProfileObservation or TrajectoryObservation
Only one observedCapability per Environmental Monitoring Facility may be defined

Normative References

INSPIRE UML-to-GeoJSON encoding rule version 0.2
Data Specification - INSPIRE Environmental Monitoring Facilities version 3.0
OGC Observations and Measurements - Simple Feature model & encodings (OMSF) version 1.0
OGC Observations and Measurements - Simple Feature GeoJSON Encoding (OMSF GeoJSON) version 1.0

Conformance Class Core

The Environmental Monitoring Facilities theme has one application schema, therefore this theme-specific encoding rule defines a single core conformance class.

Model Transformation

This section describes which rules with which parameters are applied to the Environmental Monitoring Facilities conceptual model before applying the general rules of this encoding:

Substitute all occurences of LegalCitation with the Simple Citation through Rule MT007().
Apply MT006() to add optional external information about citations.
Substitute all attributes that have a property type with a Codelist Sterotype through a simple codelist reference using MT008().
Substitute OperationalActivityPeriod with the Simple Period using MT009().
Substitute all OM and OMSO model elements through the respective OMSF model elements.
Apply the OMSF GeoJSON model mapping to the OMSO model elements.
Add the relatedMonitoringFeature property to the OMSO observation to link back to an Environmental Monitoring Facility or an Environmental Monitoring Network.
Apply the General Flattening rule to simplify the remaining properties: MT001(separator: '_').

Model Mapping

The following table explains the mapping between the classes and properties of the original Environmental Monitoring Facilities (EF) model to the Simplified Environmental Monitoring Facilities (EFS) model.

EnvironmentalMonitoringActivity

EF Name (condition)	EF Type	EFS Name	EFS Type
ef:activityConditions	CharacterString	activityConditions	String
ef:activityTime	TM_Object	activityTime	SimplePeriod
ef:boundingBox	GM_Boundary	boundingBox	GeoJSON Geometry Object
ef:onlineResource	URL	onlineResource	String[]
ef:responsibleParty	RelatedParty	responsibleParty	SimpleCitation
ef:setUpFor	anyType	setUpFor	String[]
ef:uses	anyType	uses	String[]

EnvironmentalMonitoringFacility

EF Name (condition)	EF Type	EFS Name	EFS Type
ef:additionalDescription	CharacterString	additionalDescription	String
ef:belongsTo	EnvironmentalMonitoringNetwork	belongsTo	String (Reference)
ef:broader	AbstractMonitoringObject	broader	String (Reference)
ef:geometry	GM_Object	broader	GeoJSON Geometry Object
ef:hasObservation (count() = 1)	CharacterString	hasObservation	String (Reference)
		observation_resultTime	String
		observation_result	Number
		observation_unitOfMeasureName	String
		observation_observedPropertyName	String
		observation_observedPropertyReference	String
ef:hasObservation (count() > 1)	CharacterString	hasObservation	String (Reference)
ef:involvedIn	CharacterString	involvedIn	String
ef:legalBackground	LegislationCitation	legalBackground	SimpleCitation
ef:measurementRegime	MeasurementRegimeValue	measurementRegime	(Reference)
ef:mediaMonitored	MediaValue	mediaMonitored	SimpleCodelistReference
ef:mobile	Boolean	mobile	Boolean
ef:name	CharacterString	name	String
ef:narrower	AbstractMonitoringObject	narrower	String (Reference)
ef:observingCapability	ObservingCapability	observingCapability_featureOfInterest	String (Reference)
		observingCapability_name	String
		observingCapability_time	SimplePeriod
		observingCapability_property	String
		observingCapability_onlineResource	String (URL)
		observingCapability_procedure_href	String (OM_Process, Reference)
		observingCapability_processType	SimpleCodelistReference (ProcessTypeValue)
		observingCapability_resultNature	SimpleCodelistReference (ResultNatureValue)
ef:onlineResource	URL	onlineResource	String[] (URL)
ef:operationalActivityPeriod	TM_Object	operationalActivityPeriod	SimplePeriod
ef:purpose	PurposeOfCollectionValue	purpose	SimpleCodelistReference
ef:relatedTo	AnyDomainLink	relatedTo	String (Reference)
ef:reportedTo	ReportToLegalAct	reportedTo	String (Reference)
ef:representativePoint	GM_Point	representativePoint	in-line GeoJSON property
ef:responsibleParty	RelatedParty	responsibleParty	SimpleCitation
ef:resultAcquisitionSource	ResultAcquisitionSourceValue	resultAcquisitionSource	SimpleCodelistReference
ef:specialisedEMFType	SpecialisedEMFTypeValue	specialisedEMFType	SimpleCodelistReference
ef:supersededBy	AbstractMonitoringObject	supersededBy	String[] (Reference)
ef:supersedes	AbstractMonitoringObject	supersedes	String[] (Reference)
		relatedMonitoringFeature	String (Reference)

EnvironmentalMonitoringNetwork

EF Name (condition)	EF Type	EFS Name	EFS Type
ef:additionalDescription	CharacterString	additionalDescription	String
ef:belongsTo	EnvironmentalMonitoringNetwork	belongsTo	String (Reference)
ef:broader	AbstractMonitoringObject	broader	String (Reference)
ef:contains	EnvironmentalMonitoringFacility	broader	String[] (Reference)
ef:geometry	GM_Object	broader	GeoJSON Geometry Object
ef:hasObservation (count() = 1)	CharacterString	hasObservation	String (Reference)
		observation_resultTime	String
		observation_result	Number
		observation_unitOfMeasureName	String
		observation_observedPropertyName	String
		observation_observedPropertyReference	String
ef:hasObservation (count() > 1)	CharacterString	hasObservation	String (Reference)
ef:involvedIn	CharacterString	involvedIn	String
ef:legalBackground	LegislationCitation	legalBackground	SimpleCitation
ef:mediaMonitored	MediaValue	mediaMonitored	SimpleCodelistReference
ef:name	CharacterString	name	String
ef:narrower	AbstractMonitoringObject	narrower	String (Reference)
ef:observingCapability	ObservingCapability	observingCapability_featureOfInterest	String (Reference)
		observingCapability_name	String
		observingCapability_time	SimplePeriod
		observingCapability_property	String
		observingCapability_onlineResource	String (URL)
		observingCapability_procedure_href	String (OM_Process, Reference)
		observingCapability_processType	SimpleCodelistReference (ProcessTypeValue)
		observingCapability_resultNature	SimpleCodelistReference (ResultNatureValue)
ef:onlineResource	URL	onlineResource	String[] (URL)
ef:operationalActivityPeriod	TM_Object	operationalActivityPeriod	SimplePeriod
ef:organisationLevel	LegislationLevelValue	organisationLevel	SimpleCodelistReference
ef:purpose	PurposeOfCollectionValue	purpose	SimpleCodelistReference
ef:relatedTo	AnyDomainLink	relatedTo	String
ef:reportedTo	ReportToLegalAct	reportedTo	String
ef:responsibleParty	RelatedParty	responsibleParty	SimpleCitation
ef:supersededBy	AbstractMonitoringObject	supersededBy	String[] (Reference)
ef:supersedes	AbstractMonitoringObject	supersedes	String[] (Reference)
		relatedMonitoringFeature	String (Reference)

EnvironmentalMonitoringProgramme

EF Name (condition)	EF Type	EFS Name	EFS Type
ef:additionalDescription	CharacterString	additionalDescription	String
ef:broader	AbstractMonitoringObject	broader	String (Reference)
ef:geometry	GM_Object	broader	GeoJSON Geometry Object
ef:hasObservation (count() = 1)	CharacterString	hasObservation	String (Reference)
		observation_resultTime	String
		observation_result	Number
		observation_unitOfMeasureName	String
		observation_observedPropertyName	String
		observation_observedPropertyReference	String
ef:hasObservation (count() > 1)	CharacterString	hasObservation	String (Reference)
ef:legalBackground	LegislationCitation	legalBackground	SimpleCitation
ef:mediaMonitored	MediaValue	mediaMonitored	SimpleCodelistReference
ef:name	CharacterString	name	String
ef:narrower	AbstractMonitoringObject	narrower	String (Reference)
ef:observingCapability	ObservingCapability	observingCapability_featureOfInterest	String (Reference)
		observingCapability_name	String
		observingCapability_time	SimplePeriod
		observingCapability_property	String
		observingCapability_onlineResource	String (URL)
		observingCapability_procedure_href	String (OM_Process, Reference)
		observingCapability_processType	SimpleCodelistReference (ProcessTypeValue)
		observingCapability_resultNature	SimpleCodelistReference (ResultNatureValue)
ef:onlineResource	URL	onlineResource	String[] (URL)
ef:purpose	PurposeOfCollectionValue	purpose	SimpleCodelistReference
ef:responsibleParty	RelatedParty	responsibleParty	SimpleCitation
ef:supersededBy	AbstractMonitoringObject	supersededBy	String[] (Reference)
ef:supersedes	AbstractMonitoringObject	supersedes	String[] (Reference)
ef:triggers	EnvironmentalMonitoringActivity	triggers	String[] (Reference)

Examples (Informative)

NOTE Additional examples can be added to the /efs/examples/ folder in this repository.

Example 1: One Environmental Monitoring Facility with a single measurement result (Standalone Example)

{  
   "type":"FeatureCollection",
   "features":[ 
        {
            "type": "Feature",
            "id": "EnvironmentalMonitoringFacility_1",
            "geometry": {
                "type": "Point",
                "coordinates": [ 5.18713, 46.19095 ]
            },
            "properties": {
                "description": "Water well from national BSS (Banque du Sous-Sol) Data database. Piezometer monitoring ground water level",
                "inspireId_localId": "EnvironmentalMonitoringFacility_1",
                "inspireId_namespace": "https://github.com/INSPIRE-MIF/2017.2/GeoJSON/efs/examples/",
                "identifier": "https://github.com/INSPIRE-MIF/2017.2/GeoJSON/efs/examples/EnvironmentalMonitoringFacility_1",
                "legalBackground_date": "1977-10-08T23:00:00Z",
                "legalBackground_link": "",
                "legalBackground_name": "",
                "legalBackground_level": "",
                "legalBackground_level_href": "",
                "legalBackground_type": "",
                "mediaMonitored": "water",
                "mediaMonitored_href": "http://inspire.ec.europa.eu/codelist/MediaValue/water",
                "mobile": false,
                "name": "Piézomètre de St-Rémy - 01",
                "observation_resultTime": "2017-08-17T12:11:20Z",
                "observation_result": 220.58,
                "observation_unitOfMeasureName": "m",
                "observation_observedPropertyName": "",
                "observation_observedPropertyReference": "",
                "onlineResource": "http://fichebsseau.brgm.fr/bss_eau/fiche.jsf?code=06512X0037/STREMY",
                "operationalActivityPeriod_beginPosition": "1977-10-08T23:00:00Z",
                "operationalActivityPeriod_endPosition": "2018-10-14T06:00:00Z",
                "purpose": "Ground water level measurement",
                "purpose_href": "http://www.sandre.eaufrance.fr/?urn=urn:sandre:donnees:148::CdElement:2:::referentiel:3.1:xml",
                "resultAcquisitionSource": "in-situ",
                "resultAcquisitionSource_href": "http://inspire.ec.europa.eu/codelist/ResultAcquisitionSourceValue/inSitu/",
                "specialisedEMFType": "Piezometre",
                "specialisedEMFType_href": "http://www.sandre.eaufrance.fr/urn.php?urn=urn:sandre:dictionnaire:PTE::entite:Piezometre:ressource:2.1:::html"
            }
        }
   ]
}

Example 2: One Environmental Monitoring Facility with a reference to a PointTimeSeriesObservation (Standalone Example)

{  
   "type":"FeatureCollection",
   "features":[
       {
            "type": "Feature",
            "id": "EnvironmentalMonitoringFacility_1",
            "geometry": {
                "type": "Point",
                "coordinates": [ 5.18713, 46.19095 ]
            },
            "properties": {
                "description": "Water well from national BSS (Banque du Sous-Sol) Data database. Piezometer monitoring ground water level",
                "inspireId_localId": "EnvironmentalMonitoringFacility_1",
                "inspireId_namespace": "https://https://github.com/INSPIRE-MIF/2017.2/GeoJSON/examples/efs/",
                "identifier": "https://https://github.com/INSPIRE-MIF/2017.2/GeoJSON/examples/efs/EnvironmentalMonitoringFacility_1",
                "mediaMonitored": "water",
                "mediaMonitored_href": "http://inspire.ec.europa.eu/codelist/MediaValue/water",
                "name": "Piézomètre de St-Rémy - 01",
                "haslegalBackground_href": "#MeasureTimeseriesObservation_1",
                "onlineResource": "http://fichebsseau.brgm.fr/bss_eau/fiche.jsf?code=06512X0037/STREMY",
                "operationalActivityPeriod_beginPosition": "1977-10-08T23:00:00Z",
                "operationalActivityPeriod_endPosition": "2018-10-14T06:00:00Z",
                "purpose": "Ground water level measurement",
                "purpose_href": "http://www.sandre.eaufrance.fr/?urn=urn:sandre:donnees:148::CdElement:2:::referentiel:3.1:xml",
                "resultAcquisitionSource": "in-situ",
                "resultAcquisitionSource_href": "http://inspire.ec.europa.eu/codelist/ResultAcquisitionSourceValue/inSitu/",
                "specialisedEMFType": "Piezometre",
                "specialisedEMFType_href": "http://www.sandre.eaufrance.fr/urn.php?urn=urn:sandre:dictionnaire:PTE::entite:Piezometre:ressource:2.1:::html"
            }
        },
        {
            "type": "Feature",
            "id": "PointTimeSeriesObservation_1",
            "geometry": {
                "type": "Point",
                "coordinates": [ 5.18713, 46.19095 ]
            },
            "properties": {
                "observationType": "PointTimeSeriesObservation",
                "relatedMonitoringFeature": "EnvironmentalMonitoringFacility_1",
                "phenomenonTimeStart": "2015-11-07T12:00:00Z",
                "phenomenonTimeEnd": "2015-12-19T12:00:00Z",
                "resultTime": "2015-12-19T12:11:20Z",
                "usedProcedureName": "",
                "usedProcedureReference": "",
                "observedPropertyName": "ground_water_level",
                "observedPropertyReference": "",
                "samplingFeatureName": "Piézomètre de St-Rémy - 01",
                "ultimateFeatureOfInterestName": "",
                "ultimateFeatureOfInterestReference": "",
                "timeStep": [
                    "2015-11-07T12:00:00Z",
                    "2015-11-14T12:00:00Z",
                    "2015-11-21T12:00:00Z",
                    "2015-11-28T12:00:00Z",
                    "2015-12-05T12:00:00Z",
                    "2015-12-12T12:00:00Z",
                    "2015-12-19T12:00:00Z"
                ],
                "unitOfMeasureName": "m",
                "unitOfMeasureReference": "http://www.opengis.net/def/uom/UCUM/m",
                "result": [220.91, 220.78, 220.54, 220.61, 220.28, 220.12, 220.20]
            }
        }
   ]
}

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

simple-environmental-monitoring-facilities.md

simple-environmental-monitoring-facilities.md

GeoJSON Encoding Rule for INSPIRE Environmental Monitoring Facilities

Normative References

Conformance Class Core

Model Transformation

Model Mapping

EnvironmentalMonitoringActivity

EnvironmentalMonitoringFacility

EnvironmentalMonitoringNetwork

EnvironmentalMonitoringProgramme

Examples (Informative)

JSON Schema Definition (Informative)

Files

simple-environmental-monitoring-facilities.md

Latest commit

History

simple-environmental-monitoring-facilities.md

File metadata and controls

GeoJSON Encoding Rule for INSPIRE Environmental Monitoring Facilities

Normative References

Conformance Class Core

Model Transformation

Model Mapping

EnvironmentalMonitoringActivity

EnvironmentalMonitoringFacility

EnvironmentalMonitoringNetwork

EnvironmentalMonitoringProgramme

Examples (Informative)

JSON Schema Definition (Informative)