Document History

Document no

DOCUMENT STATUS

Authors

Name / Organisation
Denis Fokin / Transas
Konstantin Ivanov / Transas

Review

Name / Organisation
Björn Andreasson / SMA
Håkan Heurlin / SMA

Approval

Name / Organisation / Signature / Date

Document History

Version / Date / Status / Initials / Description
1.0 / 2016-05-10 / Used in tendering documentation

The sole responsibility of this publication lies with the author. The European Union is not responsible for any use that may be made of the information contained therein.

Table of contents

1 Background 4

2 Objectives 5

3 The area exchange format 6

3.1 General 6

3.2 High-level description of the Area format 6

3.3 Detailed Area format description 6

3.4 Basic Area example 7

3.5 Marine Safety Information – XSD scheme 9

3.6 Feature Catalogue 25

4 Use cases 34

1 Background

This document describes an interchange format for transmitting specific areas from shore centres to ships.

The Area transmission is used to notify specific polygons allowing vessels take attention on received marine safety information and thus to plan corresponding actions.

The use of this message requires that both the receiving and transmitting side have the appropriate communication equipment as well as presentation and navigation systems.

2 Objectives

An area exchange format shall be developed, which supports all processes in the Sea Traffic Management (STM) where the area can be used:

· On board for safe navigation (ECDIS etc.)

· By Pilots

· Ashore for Sea Traffic Management services

The area format should be open and in compliance with S-1XX standards.

3 The area exchange format

3.1 General

An area exchange format between ship and shore is intended to be used both to inform the ship about the area nearby of his route and to direct the ship in required area (for example SAR-area).

File information must include the following main fields: header information, references on using of defined application schemas (S-1xx standards), geofeatures/ information types with attributes, associations. Data structure must correspond to the applied application schemas.

For example, if Sail Race event or SAR areas take place then S-124 (Navigational warning) standard (the conforming application schemas) will be applied.

All directories in the S-1xx standards are extensible. New values can be added to them at any time.

The area exchange format is a file containing the GML coded version of the area description.

3.2 High-level description of the Area format

The logical design of an area consists of three units:

· A block with general information about the area

· A block with area geometry information, which consists of blocks interior and exterior areas, which described of set of points with geographical coordinates

· A block that contains set of information types which are linked with geofeature objects by associations

3.3 Detailed Area format description

3.3.1. File components

The area file consists of:

· The mandatory XML processing instruction, which allows the specification of the encoding of string data

· A root to the applied namespace, which described data structure, as well as the area format namespace

· The version attribute in the format “Major.Minor”

3.3.2. Feature type description

This is the root element of the Area format

The feature object consists of a sequence of the following elements:

· Geofeature object (Navigational warnings, Notice to Mariners) that contains main semantic information about area including geometry information

· Information object (References, Information Notices) that contains data source information or is linked to other geofeature

· Geofeature object (Navigational warning part, Port warning part) that contains main semantic information about area including geometry information

· Information object (Navigational warning Preamble – NWPreambule, References, Information Notice Part) that contains data source information or is linked to other geofeature or information preamble.

· Association that defines the relationship between geofeatures and information objects.

3.3.3. Geofeature description

The geofeature (Navigational warnings or Notice to MarinersNavigational warning part) contains data related to the geometry of the area. It also contains semantic information, for example: category of arearestriction, textual information etc.

Information is stored in the following attributes:

Attribute / Description / Format / Status / Comment
HorizontalDatum / used Datum EPSG / enumeration / option / default - WGS84
Subject / Subject: LocalizedText / complex / option
FixedDateRange / period of validity / complex / option
extReferenceId / reference on an event, objects which are out of scope of current format / text / option

New attribute referenceUVID is added in the Geofeature Type to reference to other object as specific voyage (unique voyage ID)

3.3.4. Information object description

The Information types provides (Navigational warning Preamble – NWPreamble, References, Information Notice Part) a place to store information related to the event. Also it provides the reference to other MSI that are important or to link a cancellation notice to existing MSI which may not have an expiry date via the complex attribute CancellationTime.

Information for the NWPreamble type is stored in the following attributes:

Attribute / Description / Format / Status / Comment
messageSeriesIdentifier / messageSeriesIdentifier / complex / mandatory
GeneralArea / generalArea / enumeration / option
Locality / locality: LocalizedText / complex / option
title / title: Localized text / complex / option
FixedDateRange / period of validity / complex / option
SourceDate / Date of publication / date / option
generalCategory / category type for area / enumeration / option
affectedCharts / references on the Charts / complex / option

Information for the References type is stored in the following attributes:

Attribute / Description / Format / Status / Comment
ReferenceType / type of Reference / enumeration / mandatory
messageReference / messageSeriesIdentifier / complex / option
cancellationTime / Expired Date for warning / complex / option

Information for the Information Notice Part type is stored in the following attributes:

Attribute / Description / Format / Status / Comment
Subject / Subject: LocalizedText / complex / option
fixedDateRange / period of validity / complex / option

3.4 Basic Area example

Here example of GML-file (military exersices):

<?xml version="1.0" encoding="UTF-8"?>

<S124:DataSet xmlns:S124="http://www.iho.int/S124/gml/1.0"

xsi:schemaLocation="http://www.iho.int/S124/gml/1.0 ../../schemas/0.5/S124.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:gml="http://www.opengis.net/gml/3.2"

xmlns:S100="http://www.iho.int/s100gml/1.0"

xmlns:xlink="http://www.w3.org/1999/xlink" gml:id="III.030.17">

gml:boundedBygml:Envelope srsName="EPSG:4326">

gml:lowerCorner>-6.0000 30.0000</gml:lowerCorner

gml:upperCorner>45.0000 47.0000</gml:upperCorner

</gml:Envelope</gml:boundedBy

imember

<S124:S124_NWPreamble gml:id="PR.III.030.17">

<id>urn:mrn:s124:NW.III.030.17.P</id>

messageSeriesIdentifier

NameOfSeries>NAVAREA III</NameOfSeries

typeOfWarningNAVAREA</typeOfWarning

warningNumber30</warningNumber

year>17</year>

productionAgency

language>eng</language>

text>INSTITUTO HIDROGRÁFICO DE LA MARINA</text>

</productionAgency

country>ES</country>

</messageSeriesIdentifier

sourceDate2017-02-25</sourceDate

generalCategorymilitary exersices</generalCategory

generalAreaWestern Mediterranean Sea</generalArea

locality<text>Barcelona approaches</text</locality>

title<text>Military exercises, from 01 trough 31 MAR17 Cancel this message 01-00 UTC 01 APR</text</title>

fixedDateRange

dateStart<date>2017-03-01</date</dateStart

dateEnd<date>2017-03-31</date</dateEnd

</fixedDateRange

theWarningPart xlink:href="#NW.III.030.17.1"/>

theWarningPart xlink:href="#NW.III.030.17.2"/>

</S124:S124_NWPreamble>

</imember

<member

<S124:S124_NavigationalWarningPart gml:id="NW.III.030.17.1">

<id>urn:mrn:s124:NW.III.030.17.1</id>

geometry

<S100:surfaceProperty

gml:Surface gml:id="s.NW.III.030.17.1" srsName="EPSG:4326">

gml:patches

gml:PolygonPatch

gml:exterior

gml:LinearRing

gml:posList

41.0 1.42

41.0 1.85

40.7 1.85

40.7 1.42

41.0 1.42

</gml:posList

</gml:LinearRing

</gml:exterior

</gml:PolygonPatch

</gml:patches

</gml:Surface

</S100:surfaceProperty

</geometry>

<Subject<text>Area bounded by 041.0N 0 001-25.2E, 041.0N 001-51.0E, 40-42.0N, 001-51.0E, 40-42.0N 001-25.2E</text</Subject>

header xlink:href="#PR.III.030.17"/>

</S124:S124_NavigationalWarningPart>

</member>

imember

<S124:S124_References gml:id="NW.III.030.17.2">

referenceTypein-force</referenceType

messageReference

NameOfSeries>NAVAREA III</NameOfSeries

typeOfWarningNAVAREA</typeOfWarning

warningNumber30</warningNumber

year>17</year>

productionAgency

language>eng</language>

text>INSTITUTO HIDROGRÁFICO DE LA MARINA</text>

</productionAgency

country>ES</country>

</messageReference

cancellationTime

timeOfDayEnd01:00:00Z</timeOfDayEnd

dateEnd<date>2017-04-01</date>

</dateEnd

</cancellationTime

header xlink:href="NW.III.030.17"/>

</S124:S124_References>

</imember

</S124:DataSet

3.5 Marine Safety Information – XSD scheme

<?xml version="1.0" encoding="utf-8"?>

xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:S100="http://www.iho.int/s100gml/1.0" xmlns:s100_profile="http://www.iho.int/S-100/profile/s100_gmlProfile" xmlns:gml="http://www.opengis.net/gml/3.2" xmlns="http://www.iho.int/S124/gml/1.0" targetNamespace="http://www.iho.int/S124/gml/1.0" elementFormDefault="unqualified" version="0.0.7"

xs:annotation

xs:documentationApplication schema for Navigational warnings sample dataset</xs:documentation

</xs:annotation

xs:import namespace="http://www.iho.int/s100gml/1.0" schemaLocation="s100gmlbase.xsd"/>

xs:import namespace="http://www.opengis.net/gml/3.2" schemaLocation="./S100_gmlProfile.xsd"/>

xs:import namespace="http://www.iho.int/S-100/profile/s100_gmlProfile" schemaLocation="S100_gmlProfileLevels.xsd"/>

xs:complexType name="PointOrSurface"

xs:choice

xs:element ref="S100:pointProperty"/>

xs:element ref="S100:surfaceProperty"/>

</xs:choice

</xs:complexType

xs:complexType name="CurveOrSurface"

xs:choice

xs:element ref="S100:curveProperty"/>

xs:element ref="S100:surfaceProperty"/>

</xs:choice

</xs:complexType

xs:complexType name="PointCurveSurface"

xs:choice

xs:element ref="S100:pointProperty"/>

xs:element ref="S100:curveProperty"/>

xs:element ref="S100:surfaceProperty"/>

</xs:choice

</xs:complexType

xs:complexType name="PointOrCurve"

xs:choice

xs:element ref="S100:pointProperty"/>

xs:element ref="S100:curveProperty"/>

</xs:choice

</xs:complexType

xs:complexType name="GM_Point"

xs:choice

xs:element ref="S100:pointProperty"/>

</xs:choice

</xs:complexType

xs:complexType name="GM_Curve"

xs:choice

xs:element ref="S100:curveProperty"/>

</xs:choice

</xs:complexType

xs:complexType name="GM_Surface"

xs:choice

xs:element ref="S100:surfaceProperty"/>

</xs:choice

</xs:complexType

xs:element name="S124_FeatureType" type="S124_FeatureTypeType" abstract="true" substitutionGroup="gml:AbstractFeature"/>

xs:complexType name="S124_FeatureTypeType" abstract="true"

xs:annotation

xs:documentationGeneralized feature type which carry all the common attributes</xs:documentation

</xs:annotation

xs:complexContent

xs:extension base="S100:AbstractFeatureType"

xs:sequence

xs:element name="id" type="MRN" minOccurs="1" maxOccurs="unbounded"/>

xs:element name="extReferenceId" type="MRN" minOccurs="0" maxOccurs="unbounded"/>

xs:element name="geometry" type="PointCurveSurface" minOccurs="1" maxOccurs="unbounded"/>

xs:element name="areaAffected" type="PointCurveSurface" minOccurs="0" maxOccurs="unbounded"/>

xs:element name="radius" type="xs:float" minOccurs="0" maxOccurs="1"/>

</xs:sequence

</xs:extension

</xs:complexContent

</xs:complexType

xs:element name="S124_NavigationalWarningPart" type="S124_NavigationalWarningPartType" substitutionGroup="S124_FeatureType"/>

xs:complexType name="S124_NavigationalWarningPartType"

xs:annotation

xs:documentation xxx </xs:documentation

</xs:annotation

xs:complexContent

xs:extension base="S124_FeatureTypeType"

xs:sequence

xs:element name="horizontalDatum" type="EPSGType" minOccurs="0" maxOccurs="1"/>

xs:element name="Subject" type="S124_LocalizedTextType" minOccurs="0" maxOccurs="1"/>

xs:element name="fixedDateRange" type="fixedDateRangeType" minOccurs="0" maxOccurs="unbounded"/>

xs:element name="header" type="gml:ReferenceType" minOccurs="1" maxOccurs="1"/>

</xs:sequence

</xs:extension

</xs:complexContent

</xs:complexType

xs:element name="S124_InformationType" type="S124_InformationTypeType" abstract="true"/>

xs:complexType name="S124_InformationTypeType" abstract="true"

xs:annotation

xs:documentationGeneralized information type which carry all the common attributes</xs:documentation

</xs:annotation

xs:complexContent

xs:extension base="S100:AbstractInformationType"

xs:sequence

xs:element name="id" type="MRN" minOccurs="1" maxOccurs="1"/>

xs:element name="provides" type="gml:ReferenceType" minOccurs="0" maxOccurs="1"/>

</xs:sequence

</xs:extension

</xs:complexContent

</xs:complexType

xs:element name="S124_NWPreamble" type="S124_NWPreambleType" substitutionGroup="S124_InformationType"/>

xs:complexType name="S124_NWPreambleType"

xs:annotation

xs:documentation xxx </xs:documentation

</xs:annotation

xs:complexContent

xs:extension base="S124_InformationTypeType"

xs:sequence

xs:element name="messageSeriesIdentifier" type="S124_messageSeriesIdentifierType" minOccurs="1" maxOccurs="1"/>

xs:element name="sourceDate" type="xs:date" minOccurs="0" maxOccurs="1"/>

xs:element name="generalCategory" type="generalCategoryType" minOccurs="0" maxOccurs="1"/>

xs:element name="generalArea" type="generalAreaType" minOccurs="0" maxOccurs="1"/>

xs:element name="locality" type="S124_LocalizedTextType" minOccurs="0" maxOccurs="unbounded"/>

xs:element name="title" type="S124_LocalizedTextType" minOccurs="0" maxOccurs="1"/>

xs:element name="fixedDateRange" type="fixedDateRangeType" minOccurs="0" maxOccurs="unbounded"/>

xs:element name="affectedCharts" type="S124_affectedChartType" minOccurs="0" maxOccurs="unbounded"/>

xs:element name="theWarningPart" type="gml:ReferenceType" minOccurs="0" maxOccurs="unbounded"/>

</xs:sequence

</xs:extension

</xs:complexContent

</xs:complexType

xs:element name="S124_InformationNoticePart" type="S124_InformationNoticePartType" substitutionGroup="S124_InformationType"/>

xs:complexType name="S124_InformationNoticePartType"

xs:annotation

xs:documentation xxx </xs:documentation

</xs:annotation

xs:complexContent

xs:extension base="S124_InformationTypeType"

xs:sequence

xs:element name="Subject" type="S124_LocalizedTextType" minOccurs="0" maxOccurs="unbounded"/>

xs:element name="fixedDateRange" type="fixedDateRangeType" minOccurs="0" maxOccurs="unbounded"/>

xs:element name="header" type="gml:ReferenceType" minOccurs="1" maxOccurs="1"/>

</xs:sequence

</xs:extension

</xs:complexContent

</xs:complexType

xs:element name="S124_References" type="S124_ReferencesType" substitutionGroup="S124_InformationType"/>

xs:complexType name="S124_ReferencesType"

xs:annotation

xs:documentation xxx </xs:documentation

</xs:annotation

xs:complexContent

xs:extension base="S124_InformationTypeType"

xs:sequence

xs:element name="referenceType" type="S124_referenceTypeType" minOccurs="1" maxOccurs="1"/>

xs:element name="messageReference" type="S124_messageSeriesIdentifierType" minOccurs="0" maxOccurs="unbounded"/>

xs:element name="cancellationTime" type="cancellationTimeType" minOccurs="0" maxOccurs="unbounded"/>

xs:element name="header" type="gml:ReferenceType" minOccurs="1" maxOccurs="1"/>

</xs:sequence

</xs:extension

</xs:complexContent

</xs:complexType

xs:complexType name="S124_LocalizedTextType"

xs:sequence

xs:element name="language" type="ISO639-3" minOccurs="0" maxOccurs="1"/>

xs:element name="text" type="xs:string" minOccurs="1" maxOccurs="1"/>

</xs:sequence

</xs:complexType

xs:complexType name="fixedDateRangeType"

xs:annotation

xs:documentationDescribes a single fixed period, as the date range between its sub-attributes.

Remarks: Sub-attributes date end and date start must have the calendar year encoded using 4 digits for the calendar year (CCYY). Month (MM) and day (DD) are optional.

(This definition merges the planned S-100 temporal model with the current S-101 DCEG definition of fixed date range.)</xs:documentation

</xs:annotation

xs:sequence

xs:element name="timeOfDayStart" type="xs:time" minOccurs="0" maxOccurs="1"/>

xs:element name="timeOfDayEnd" type="xs:time" minOccurs="0" maxOccurs="1"/>

xs:element name="dateStart" type="S100_TruncatedDate" minOccurs="0" maxOccurs="1"

xs:annotation

xs:documentationThe start date or time of the interval.</xs:documentation

</xs:annotation

</xs:element

xs:element name="dateEnd" type="S100_TruncatedDate" minOccurs="0" maxOccurs="1"

xs:annotation

xs:documentationThe end date or time of the interval.</xs:documentation

</xs:annotation

</xs:element

</xs:sequence

</xs:complexType

xs:complexType name="cancellationTimeType"

xs:annotation

xs:documentationDescribes a end date before that message is left in-force.

Remarks: Sub-attributes date end must have the calendar year encoded using 4 digits for the calendar year (CCYY). Month (MM) and day (DD) are optional.

(This definition merges the planned S-100 temporal model with the current S-101 DCEG definition of fixed date range.)</xs:documentation

</xs:annotation

xs:sequence

xs:element name="timeOfDayEnd" type="xs:time" minOccurs="0" maxOccurs="1"/>

xs:element name="dateEnd" type="S100_TruncatedDate" minOccurs="0" maxOccurs="1"

xs:annotation

xs:documentationThe end date\time.</xs:documentation

</xs:annotation

</xs:element

</xs:sequence

</xs:complexType

xs:complexType name="S124_messageSeriesIdentifierType"

xs:annotation

xs:documentation xxx </xs:documentation

</xs:annotation

xs:sequence

xs:element name="NameOfSeries" type="xs:string" minOccurs="1" maxOccurs="1"/>

xs:element name="typeOfWarning" type="S124_typeOfWarningType" minOccurs="1" maxOccurs="1"/>

xs:element name="warningNumber" type="xs:int" minOccurs="1" maxOccurs="1"/>

xs:element name="year" type="xs:int" minOccurs="1" maxOccurs="1"/>

xs:element name="productionAgency" type="S124_LocalizedTextType" minOccurs="1" maxOccurs="unbounded"/>

xs:element name="country" type="countryType" minOccurs="1" maxOccurs="1"/>

</xs:sequence

</xs:complexType

xs:complexType name="S124_affectedChartType"

xs:sequence

xs:element name="chartAffected" type="xs:string" minOccurs="0" maxOccurs="1"/>

xs:element name="internationalChartAffected" type="xs:string" minOccurs="0" maxOccurs="1"/>

xs:element name="language" type="ISO639-3" minOccurs="0" maxOccurs="1"/>

</xs:sequence

</xs:complexType

xs:simpleType name="generalAreaType"

xs:restriction base="xs:string"

xs:enumeration value="Baltic sea"

</xs:enumeration

xs:enumeration value="Skagerrak"

</xs:enumeration

xs:enumeration value="Kattegat"

</xs:enumeration

xs:enumeration value="Lake Vänern and Trollhätte Canal"

</xs:enumeration

xs:enumeration value="The Sound"

</xs:enumeration

xs:enumeration value="The Belts"

</xs:enumeration

xs:enumeration value="Western Baltic"

</xs:enumeration

xs:enumeration value="Southern Baltic"

</xs:enumeration

xs:enumeration value="South-eastern Baltic"

</xs:enumeration

xs:enumeration value="Central Baltic"

</xs:enumeration

xs:enumeration value="Lake Mälaren and Södertälje Canal"

</xs:enumeration

xs:enumeration value="Northern Baltic"

</xs:enumeration

xs:enumeration value="Gulf of Riga"

</xs:enumeration

xs:enumeration value="Gulf of Finland"

</xs:enumeration

xs:enumeration value="Sea of Åland and Archipelago Sea"

</xs:enumeration

xs:enumeration value="Sea of Bothnia"

</xs:enumeration

xs:enumeration value="The Quark"

</xs:enumeration

xs:enumeration value="Bay of Bothnia"

</xs:enumeration

xs:enumeration value="Other lakes and canals"

</xs:enumeration

xs:enumeration value="Western Mediterranean Sea"

</xs:enumeration

</xs:restriction

</xs:simpleType

xs:simpleType name="MRN"

xs:annotation

xs:documentationMarine Resource Name identifier, based on URN. Note that the NID, including the mrn: prefix can be no more than 31 characters long</xs:documentation

</xs:annotation

xs:restriction base="xs:string"

xs:pattern value="urn:mrn:[A-Za-z0-9][A-Za-z0-9-]{0,27}:[A-Za-z0-9()+,\-.:=@;$_!*'%/?#]+"/>

</xs:restriction

</xs:simpleType

xs:simpleType name="S124_referenceTypeType"

xs:restriction base="xs:string"

xs:enumeration value="cancellation"

</xs:enumeration

xs:enumeration value="source reference"

</xs:enumeration

xs:enumeration value="in-force"

</xs:enumeration

</xs:restriction

</xs:simpleType

xs:simpleType name="S124_typeOfWarningType"

xs:restriction base="xs:string"

xs:enumeration value="local"

</xs:enumeration

xs:enumeration value="coastal"

</xs:enumeration

xs:enumeration value="sub-area"

</xs:enumeration

xs:enumeration value="NAVAREA"

</xs:enumeration

</xs:restriction

</xs:simpleType

xs:simpleType name="EPSGType"

xs:restriction base="xs:string"

xs:enumeration value="4326"

</xs:enumeration

</xs:restriction

</xs:simpleType

xs:simpleType name="generalCategoryType"

xs:restriction base="xs:string"

xs:enumeration value="aids to navigation"

</xs:enumeration

xs:enumeration value="dangerous wreck"

</xs:enumeration

xs:enumeration value="unwleldy tow"

</xs:enumeration

xs:enumeration value="drifting hazard"

</xs:enumeration

xs:enumeration value="SAR and anti pollution operations"

</xs:enumeration

xs:enumeration value="newly discovered dangers"

</xs:enumeration

xs:enumeration value="route alterations or suspensions"

</xs:enumeration

xs:enumeration value="underwater operations"

</xs:enumeration

xs:enumeration value="pipe or cable laying operations"

</xs:enumeration

xs:enumeration value="seismic surveys"

</xs:enumeration

xs:enumeration value="research or scientific operations"

</xs:enumeration

xs:enumeration value="offshore structures"

</xs:enumeration

xs:enumeration value="radio navigation services"

</xs:enumeration

xs:enumeration value="special operations"

</xs:enumeration

xs:enumeration value="operating anomalies identified within ECDIS including ENC issues"

</xs:enumeration

xs:enumeration value="security-related requirements"

</xs:enumeration

xs:enumeration value="piracy"

</xs:enumeration

xs:enumeration value="tsunamis and other natural phenomena"

</xs:enumeration

xs:enumeration value="World Health Organization (WHO) health advisory information"

</xs:enumeration

xs:enumeration value="SailRaceEvent"

</xs:enumeration

xs:enumeration value="military exersices"

</xs:enumeration

</xs:restriction

</xs:simpleType

xs:simpleType name="countryType"

xs:restriction base="xs:string"

xs:enumeration value="SE"

</xs:enumeration

xs:enumeration value="RU"

</xs:enumeration

xs:enumeration value="GB"

</xs:enumeration

xs:enumeration value="DK"

</xs:enumeration

xs:enumeration value="FI"

</xs:enumeration

xs:enumeration value="NO"

</xs:enumeration

xs:enumeration value="EE"

</xs:enumeration

xs:enumeration value="LV"

</xs:enumeration

xs:enumeration value="LT"

</xs:enumeration

xs:enumeration value="PL"

</xs:enumeration

xs:enumeration value="DE"

</xs:enumeration

xs:enumeration value="ES"

</xs:enumeration

</xs:restriction

</xs:simpleType