Inleiding¶

De datadienst reistijden bevat Minuutgegevens van reistijden over vooraf gedefinieerde meetvakken; levering op uiterlijk 60 seconde na de meetminuut. De reistijden bevat de actuele verkeersstatus uitgedrukt in reistijd tussen twee geografische punten op een weg. Afhankelijk van de bepalingen van de betreffende wegbeheerder, zal de reistijd een weergave zijn van (1) gerealiseerde reistijd, of (2) geschatte reistijd.

De bestanden worden als open data beschikbaar gesteld op opendata.ndw.nu als traveltime.xml (periodieke gegevens met betrekking tot de reistijden) en measurement_current.xml (configuratie gegevens van de meetvakken).

Voor meer informatie over de opbouw van de MeasurementSiteTablePublication (measurement_current.xml) kun je hier klikken.

Structuur en inhoud¶

Algemeen¶

De datadienst reistijden behoort tot de actuele verkeersgegevens. Hiervoor wordt in de Datex II structuur de specialisatie (xsi:type) MeasuredDataPublication van PayloadPublication gebruikt.

In de onderstaande afbeelding is de hoofdstructuur weergegeven.

In de het onderstaande voorbeeld wordt het gebruik van de belangrijkste elementen in deze datadienst toegelicht.

Voorbeeld¶

Het bestand/soap bericht met de periodieke gegevens van reistijden start met de standaard DatexII elementen voor de levering (zie voorbeeld XML hieronder). Het element exchange wordt gebruikt om parameters uit te wisselen die gerelateerd zijn aan de levering, in dit geval de details van de toeleverende partij.

<d2LogicalModel xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" modelBaseVersion="2" xmlns="http://datex2.eu/schema/2/2_0">
  <exchange>
   <supplierIdentification>
     <country>nl</country>
     <nationalIdentifier>NLNDW</nationalIdentifier>
   </supplierIdentification>
  </exchange>
  <payloadPublication lang="nl" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="MeasuredDataPublication">
    <publicationTime>2017-08-09T08:52:40.008Z</publicationTime>
    <publicationCreator>
      <country>nl</country>
          <nationalIdentifier>NLNDW</nationalIdentifier>
    </publicationCreator>
    <measurementSiteTableReference targetClass="MeasurementSiteTable" version="932" id="NDW01_MT"/>
    <headerInformation>
      <confidentiality>noRestriction</confidentiality>
      <informationStatus>real</informationStatus>
    </headerInformation>
  ..
  </payloadPublication>
</d2LogicalModel>

In het bovenstaande voorbeeld is met het attribuut xsi:type van de PayloadPublication aangegeven dat gebruik is gemaakt van de specialisatie “MeasuredDataPublication”. Daarnaast zijn de volgende elementen gebruikt waarmee extra informatie over de gegevenslevering wordt verstrekt .

De daadwerkelijke reistijdgegevens zijn terug te vinden in het element siteMeasurements (zie XML voorbeeld hieronder). De verwijzing naar de meetlocatie binnen de measurementSiteTable gebeurt door middel van de attributen van het element measurementSiteReference. Daarnaast wordt de starttijd van de meetminuut aangegeven in measurementTimeDefault.

<siteMeasurements>
  <measurementSiteReference id="RWS04_T_0258_ID_265" version="1" targetClass="MeasurementSiteRecord"/>
  <measurementTimeDefault>2017-08-09T08:52:00.000Z</measurementTimeDefault>
  <measuredValue index="1" xsi:type="_SiteMeasurementsIndexMeasuredValue">
    <measuredValue xsi:type="MeasuredValue">
      <basicData xsi:type="TravelTimeData">
        <travelTimeType>reconstituted</travelTimeType>
        <travelTime>
          <duration>58.659</duration>
        </travelTime>
      </basicData>
      <measuredValueExtension>
        <measuredValueExtended>
          <basicDataReferenceValue>
            <referenceValueType>staticReferenceValue</referenceValueType>
            <travelTimeData>
              <travelTimeType>reconstituted</travelTimeType>
              <travelTime>
                <duration>51.979</duration>
              </travelTime>
            </travelTimeData>
          </basicDataReferenceValue>
        </measuredValueExtended>
      </measuredValueExtension>
    </measuredValue>
  </measuredValue>
</siteMeasurements>

De gemeten waarde en de typering van de waarde wordt vastgelegd in de specialisatie “TravelTimeData” van het element basicData (zie ook het voorbeeld hierboven). Bij een eventuele foutieve meting wordt binnen basicData het subelement dataError gebruikt om dit aan te geven. Over de wijze hoe dit wordt gedaan klik hier. Daarnaast is de referentiewaarde opgenomen binnen het element basicDataReferenceValue in de measuredValueExtension. Een typering van de referentiewaarde vindt plaats met behulp van het element referenceValueType. Daarnaast is de structuur van basicData overgenomen onder travelTimeData om de referentiewaarde mee aan te geven.