Locatiereferentie NL profiel DATEX II Versie 3.4¶

Vastgesteld op 27 Juni 2025¶

Hieronder worden de mogelijke locatiereferentie methodes beschreven ten behoeve van het Nederlandse DATEX II versie 3 profiel voor situatieberichten zoals vastgesteld in 2025. De andere profielen gebruiken de vigerende versie.

Alle mogelijke elementen en attributen worden generiek benoemd, zie voor het gebruik de specifieke profielen.

LocationReference¶

De abstracte klasse LocationReference wordt gebruikt voor het beschrijven van één of meer fysiek gescheiden locaties. Wij kennen drie verschillende locatie beschrijvingen; punten, lijnen en gebieden. Wanneer er meerdere locaties beschreven zijn binnen een LocationReference kunnen deze gerelateerd zijn, zoals in een reisroute (of route), maar ze kunnen ook niet gerelateerd zijn.

Per locatiebeschrijving gebruiken wij de volgende specialisaties (xsi:types):

De top-level structuur is als volgt:

Algemene Attributen¶

Door middel van overerving via Location en/of NetworkLocation kunnen ExternalReferencing, en SupplementaryPositionalDescription worden toegevoegd.

Via NetworkLocation en Itinerary kan er ook nog een Destination worden toegevoegd, indien er een bestemmingslocatie benoemd moet worden.

ExternalReferencing¶

ExternalReferencing is een niet verplicht element wat een locatie definieert door verwijzing naar een extern/ander referentiesysteem. Hierbij wordt gebruik gemaakt van:

In de specifieke usecases is te vinden wanneer en hoe deze velden gebruikt worden.

SupplementaryPositionalDescription¶

supplementaryPositionalDescription beschrijft aanvullende locatie-informatie, zoals de specifieke rijbaan, rijstroken of de lengte van een locatie. Het element bestaat uit één (of meer) optionele elementen locationDescriptor én één (of meer) verplicht(e) element(en) affectedCarriagewayAndLanes.

carriageway¶

Met behulp van carriageway wordt aanvullende rijbaaninformatie opgenomen over (het eindpunt van) de locatie.

Lane¶

De volgende richtlijnen dienen gebruikt te worden bij het benoemen van rijstroken:

• Stroken, behalve bus-, wissel- en vluchtstroken, worden in volgorde vanuit de wegoriëntatielijn (WOL)/wegas aangeduid met een Integer. Gezien vanuit de weggebruiker is rijstrook 1 dus uiterst links
• In afwijking van het gestelde in (a) wordt een spitsstrook die ter linkerzijde van de rijbaan erbij komt aangeduid met de waarde rushHourLane
• Een busstrook wordt in alle gevallen aangeduid met busLane
• Een wisselstrook wordt in alle gevallen aangeduid met tidalFlowLane
• Een vluchtstrook, waarover informatie beschikbaar is (bijvoorbeeld een spitsstrook ter rechterzijde), wordt aangeduid als hardShoulder
• Indien bedoeld wordt de gehele rijbaan aan te duiden, wordt gebruik gemaakt van de waarde allLanesCompleteCarriageWay.

RoadInformation¶

Dit onderdeel geeft de mogelijkheid tekstuele beschrijving toe te voegen middels:

Destination¶

Een Destination beschrijft een bestemmingslocatie en is altijd van het type pointDestination. Dit element mag alleen gebruikt worden bij omleidingen en is gevuld met een pointLocation van het type PointByCoordinates.

OpenLr binary extensions¶

Voor elke type locatie is het ook mogelijk de binaire waarde van OpenLr te beschrijven in LinearLocationExtended, OpenLrPointExtended, OpenLrAreaExtended met het atribuut openLrAsBinary van het type 'String'.

PointLocation¶

Deze specialisatie wordt toegepast als de locatiebeschrijving bestaat uit een enkel punt op een weg of in een regio. Point is afgeleid van het abstracte element NetworkLocation. NetworkLocation is afgeleid van het element Location.

De structuur van de specialisatie is als volgt:

Binnen het Nederlands Profiel zijn de onderstaande elementen toegestaan om te gebruiken. Verplichting van de elementen kan verschillen per usecase.

pointByCoordinates¶

Het element pointByCoordinates wordt gebruikt om aan de hand van coördinaten het punt te beschrijven. Het element is rijker dan het element pointCoordinates, doordat er een richting (bearing) opgenomen wordt. Het opnemen van de richting is van groot belang voor de correcte interpretatie van de locatie.

PointCoordinates¶

Dit element geeft het punt weer aan de hand van coördinaten op basis van het WGS84 systeem. Het World Geodetic System 1984 (WGS84) is het coördinatenreferentiesysteem voor de aarde dat is ontworpen voor gps. WGS84 wordt standaard gebruikt door gps-ontvangers (hoewel ook andere coördinatenreferentiesystemen kunnen worden ingesteld). Daardoor is WGS84 een van de meest gebruikte wereldwijde coördinatenreferentiesystemen. Het type PointCoordinates wordt vaak gebruikt als type van een element binnen een overkoepelend element.

Het type PointCoordinates wordt vaak gebruikt als type van een element binnen een overkoepelend element, zoals bij coordinatesForDisplay.

alertCPoint¶

Het abstracte element alertCPoint wordt gebruikt om de locatie te beschrijven op basis van VILD. Het element kan van het type AlertCMethod2Point of AlertCMethod4Point zijn. Deze specialisatie wordt aangegeven middels het attribuut xsi-type. De specialisaties bepalen de subelementen.

AlertCMethod2Point en AlertCMethod4Point¶

Beide specialisaties beschrijven een enkel punt op het wegennet gedefinieerd door verwijzing naar een punt in een vooraf gedefinieerde ALERT-C locatietabel met de bijbehorende verkeersstroomrichting. Waarbij er bij AlerCMethod4Point ook nog een OffsetDistance wordt meegegeven.

In onderstaande afbeelding is AlertCMethod4Point ter illustratie toegevoegd.

Beide bevatten zodoende een alertCDirection welke de volgende subelementen bevat:

alertCLocation¶

Het element alertCLocation is verplicht voor: alertCmethod2PrimaryPointLocation, alertCmethod4PrimaryPointLocation, alertCmethod2SecondaryPointLocation en alertCmethod4SecondaryPointLocation . Optioneel wordt ook de naam van de locatie opgenomen.

AlertCMethod4Point¶

Deze specialisatie onderscheidt zich door toevoeging van het verplichte element offsetDistance met de afstand (in stroomrichting) tussen de alertCLocation.specificLocation en de locatie uitgedrukt in meters

openlrPoint¶

Het element openLrPointLocationReference is een abstract element van het type OpenLrPointLocationReference. Bij het gebruikt dient een van onderstaande specialisaties te worden aangegevens middels het attribuut xsi-type.

de structuur is als volgt:

OpenlrPointAlongLine¶

OpenlrPoiWithAccesPoint¶

De specialisatie OpenlrPoiWithAccessPoint is in de basis identiek aan OpenlrPointAlongLine, het voegt enkel nog het volgende element toe:

LocationGroupByList¶

Indien bij een gebeurtenis een groot aantal locaties wordt afgesloten op hetzelfde tijdstip zonder dat hier sprake is van een traject of geografische samenhang/ordening (bijvoorbeeld een evenement waarbij een heel stadscentrum wordt afgesloten) mag LocationGroupByList gebruikt worden. Voor overige toepassingen van locatiereferentie dient LocationGroupByList niet gebruikt te worden.

LinearLocation in een ItineraryByIndexedLocations¶

ItineraryByIndexedLocations wordt als standaard toegepast binnen trajectlocaties. Toepassing vindt ook plaats bij de beschrijving van een omleidingsroute. Het element locationReference van type ItineraryByIndexedLocations bestaat uit één of meer elementen locationContainedInItinerary:

LocationContainedInItinerary¶

Het element LocationContainedInItinerary wordt gebruikt om een geordende lijst van locaties op te kunnen nemen. Het element LocationContainedInItinerary wordt met het attribuut xsi-type gespecialiseerd naar een LinearLocation of SingleRoadLinearLocation. De ordering wordt vastgelegd met behulp van het verplichte attribuut index. Hierbij wordt begonnen met index waarde 0 waarna opvolgend doorgenummerd wordt.

Een binnen de itinerary uniek en aaneengesloten volgnummer. Hierbij wordt begonnen met de waarde 0.

• index 0 is altijd een LinearLocation met daarin een gmlLinestring en eventueel openLR.
• Index 1 - n wordt gevuld met SingleRoadLinearLocation met daarin de VILD referenties.

LinearLocation¶

Deze specialisatie wordt toegepast als de locatiebeschrijving van een traject. LinearLocation is afgeleid van het abstracte element NetworkLocation. NetworkLocation is afgeleid van het element Location.

De structuur van de specialisatie is als volgt:

Binnen het Nederlands Profiel zijn de onderstaande elementen toegestaan om te gebruiken. Verplichting van de elementen verschilt per profiel.

SingleRoadLinearLocation¶

Voor het opnemen van alertClinears gebruiken we vanaf index 1, één of meerdere elementen SingleRoadLinear. SingleRoadLinearLocation is afgeleid van LinearLocation. LinearLocation is afgeleid van het abstracte element NetworkLocation. NetworkLocation is afgeleid van het element Location. De structuur van de specialisatie is als volgt:

Binnen het Nederlands Profiel zijn de onderstaande elementen toegestaan om te gebruiken. Verplichting van de elementen verschilt per profiel.

alertCLinear¶

Het element alertCLinear wordt gebruikt om de lijn locatie te beschrijven op basis van VILD, en heeft twee mogelijke xsi:type:

• AlertCMethod2Linear wordt gebruikt indien er directe verwijzingen worden opgenomen naar de betreffende AlertC (VILD) locaties
• AlertCMethod4Linear wordt gebruikt indien er sprake is van een locatie op een bepaald afstand (offset) ten opzichte van de AlertC (VILD) start- en eindlocatie

Een verbindingsweg of toe- of afrit wordt opgenomen als puntlocatie waarbij geldt dat:

• de verbindingsweg wordt gerelateerd aan de situatie op de rijbaan waaraan deze stroomopwaarts is gesitueerd (divergentiepunt)
• de afrit wordt gerelateerd aan de situatie op de rijbaan waaraan deze stroomopwaarts is gesitueerd (divergentiepunt)
• de toerit wordt gerelateerd aan de situatie op de rijbaan waaraan deze stroomafwaarts is gesitueerd (convergentiepunt)

VILD kan alleen worden toegepast als op het volledige traject VILD beschikbaar is. Wanneer VILD niet over het gehele traject beschikbaar is, dient locatiereferentie met VILD achterwege te blijven.

In alle gevallen worden onderstaande attributen meegegeven:

Method2, en Method4¶

Beide methodes beschrijven een lijn locatie langs een weg tussen twee punten, Primair en Secundair, die vooraf zijn gedefinieerd in een ALERT-C locatietabel. De richting is VAN HET Secundaire punt NAAR het Primaire punt, d.w.z. het Primaire punt is stroomafwaarts van het Secundaire punt. In dat geval wordt de AlertCLocation meegegeven aan zowel de primary als de secundary point.
Waarbij er bij AlerCMethod4Point ook nog een OffsetDistance wordt meegegeven.

Zie onderstaand diagram van de twee varianten:

gmlLineString¶

Het element gmlLineString wordt gebruikt om een reeks coörindaten te definiëren die gezamenlijk de geografische locatie beschrijven. Toepassing van de gmlLineString kan zijn in de vorm van een polyline, maar ook in de vorm van een polygoon. Uitgangspunt is dat een linestring minimaal alle routebepalende coördinaten beschrijft en dat deze coördinaten afwijkend zijn van elkaar.

Het element gmlLineString heeft 3 attributen:

GmlPosList¶

Het element GmlPosList is afgeleid van het type LongString, wat in de basis een xs:string is. De inhoud van het element is beperkt door middel van een restrictief patroon. Het toegestane patroon is:

[-+]?[0-9]*\.?[0-9]+(\s[-+]?[0-9]*\.?[0-9]+){3,}

OpenlrLinear¶

Het element openlrLinear bevat het verplichte element firstDirection om de lijn locatie in OpenLR te coderen. De locatiereferentie is opgebouwd uit routebepalende knopen op een netwerk van lijnen, waarbij tenminste het startpunt en eindpunt zijn opgenomen.

De structuur is als volgt:

openlrLocationReferencePoint en openlrLastLocationReferencePoint¶

Deze elementen bevatten informatie over het start- of eindpunt van de referentielijn in de rijrichting.
Ze zijn vrijwel identiek opgebouwd maar voor openlrLastLocationReferencePoint, wordt het element openlrPathAttributes niet gebruikt.

openlrLineAttributes¶

Het element openlrLineAttributes beschrijft de eigenschappen van de referentielijn. Het element heeft drie verplichte elementen: openlrFunctionalRoadClass, openlrFormOfWay, openlrBearing.

openlrPathAttributes¶

openlrOffsets¶

AreaLocation¶

Deze specialisatie wordt toegepast als de locatiebeschrijving bestaat uit een gebied. De structuur van de specialisatie is als volgt:

Binnen het Nederlands profiel zijn de onderstaande elementen toegestaan om te gebruiken. Verplichting van de elementen kan verschillen per usecase.

alertCArea¶

Het element alertCArea wordt gebruikt om de gebiedslocatie te beschrijven op basis van VILD.

gmlMultiPolygon¶

Het element gmlMultiPolygon wordt gebruikt om de gebiedslocatie te beschrijven op basis van een of meerdere polygonen. Elk polygoon wordt gedefinieerd door één externe lineaire ring en nul tot meerdere interne lineaire ringen die interne gebieden definiëren.

Het element gmlMultiPolygon bevat een specifieke lineaire ring, een niet-zelfdoorsnijdende gesloten curve afgeleid van een lijnstring, waarbij de laatste coördinaat hetzelfde is als de eerste. De overige coördinaten zijn afwijkend van het start/eindpunt. Zo'n lineaire ring bestaat uit minimaal vier posities. Deze lineaire ring is niet-zelfdoorsnijdend om het creëren van gefragmenteerde (niet-compacte) gebieden te voorkomen, aangezien meerdere externe ringen kunnen worden gekoppeld aan een instantie van de klasse GmlMultiPolygon.

GmlPolygon¶

GmlLinearRing¶

Het element GmlLinearRing is afgeleid van het type GmlLineString en voegt enkel de mogelijkheid toe om extensies op te nemen op het basistype.

namedArea¶

Een gebied gedefinieerd door een naam en/of in termen van bekende grenzen, zoals land- of provinciegrenzen of toegewezen controlegebied van een bepaalde autoriteit. De attributen vormen geen eenheid; in plaats daarvan vormt de kleinste kruising het resulterende gebied

openlrAreaLocationReference¶

Het element openlrAreaLocationReference is een abstract element van het type OpenlrAreaLocationReference. Bij het gebruikt dient een van onderstaande specialisaties te worden aangegevens middels het attribuut xsi-type.

OpenlrCircleLocationReference¶

Met een element van het type OpenlrCircleLocationReference wordt een gebied beschreven aan de hand van een cirkel. Deze cirkel wordt beschreven met de locatie van het middelpunt middels het verplichte element openlrGeoCoordinate en de straal van de cirkel (middels het verplichte element radius).

OpenlrClosedLineLocationReference¶

Met een element van het type OpenlrClosedLineLocationReference wordt een gebied beschreven aan de hand van een gesloten pad. Dit pad wordt beschreven aan de hand van een reeks van minimaal twee elementen openlrLocationReferencePoint van het type OpenlrLocationReferencePoint. Vervolgens wordt met behulp van het verplichte element openlrLastLine van het type OpenlrLineAttributes het sluitstuk tussen de laatste en de eerste locatie op het pad beschreven.

OpenlrGridLocationReference¶

Met een element van het type OpenlrGridLocationReference wordt een gebied beschreven aan de hand van een grid (raster). Deze grid wordt beschreven aan de hand van een rechthoek (element openlrRectangle) en het aantal kolommen en regels (element openlrGridAttributes).

OpenlrRectangle¶

OpenlrPolygonLocationReference¶

Met een element van het type OpenlrPolygonLocationReference wordt een gebied beschreven aan de hand van een reeks coördinaten.