How to Use Feature Layer PTV_GeneralTruckRestrictions

The Feature Layer PTV_GeneralTruclRestrcitions provides data about implicit time dependent truck restrictions like weekends, holidays and public days which are influencing truck routes.

Related Topics

The following topics might be relevant for this use case.

• About Feature Layer
• About Profiles

Terminology

Feature Layer

The Feature Layer (FL) defines the additional data mechanism. The data is partitioned into several themes that characterize different use cases. For example PTV_GeneralTruckRestrictions is such additional data.

Benefits

PTV xRoute Server

• Using the Feature Layer PTV_GeneralTruckRestrictions you gain more realistic routing results respecting general restrictions for trucks on weekends, holidays and public days.

Prerequisites

Check, if the following prerequisites are fulfilled before you start with the use case.

• PTV xRoute Server and a digital map of the area for route calculation.

• Correct installation of the Feature Layer PTV_GeneralTruckRestrictions. The usage of this Feature Layer with the PTV xRoute Server is only available in version 1.22.0 or higher.

• In order to request information from the Feature Layer theme PTV_GeneralTruckRestrictions, you need to ensure that your license includes the following keys:

  • PTV xRoute Server: xroute.featureLayerThemes=PTV_GeneralTruckRestrictions
  • PTV xMap Server: xmap.featureLayerThemes=PTV_GeneralTruckRestrictions

Concept

Feature layers are designed to provide various additional data to the user. The content depends on the feature layer theme and can be configured via XML profile. In the PTV xRoute server, feature layer data can be requested as generic FeatureDescription element for each route segment.

Content of the Feature Layer PTV_GeneralTruckRestrictions

The Feature Layer PTV_GeneralTruckRestrictions includes following countries and truck specific restrictions.

Germany

• General public ban on Sundays and public holidays from 00:00 to 22:00 hours for vehicles with a weight larger than 7.5 tones
• General public ban on Sundays and public holidays from 00.00 to 22.00 hours for vehicles with trailers

Austria

• General public ban on Saturdays from 15:00 to 24:00; Sundays and public holidays from 00.00 to 22.00 hours for vehicles with a weight larger than 7.5 tones

• General public ban on Saturdays from 15:00 to 24:00; Sundays and public holidays from 00.00 to 22.00 hours for vehicles with a weight larger than 3.5 tones which have any additionally trailer

Switzerland

• General public ban on Sundays and public holidays from 00:00 to 24:00 hours vehicles with a weight larger than 3.5 tones
• General ban at night from 22:00 to 05:00 hours for vehicles with a weight larger than 3.5 tones

Liechtenstein

• General public ban on Sundays and public holidays from 00:00 to 24:00 hours for vehicles with a total weight larger than 5 tones
• General public ban on Sundays and public holidays from 00:00 to 24:00 hours for vehicle combinations with a total weight larger than 5 tones

France

• General public ban from 22:00 on Saturdays until 22:00 on Sundays and public holidays for trucks with a weight larger than 7.5 tones
• General public ban from 22:00 on Saturdays until 22:00 on Sundays and public holidays for vehicles combination with a weight larger than 7.5 tones

Furthermore the Feature Layer PTV_GeneralTruckRestrictions supports several public holidays with constant and varying date. The tables below list the public holidays of the supported countries.

Public holidays with a constant date

Date	Official Name	Germany 00:00 - 22:00	France 00:00 - 22:00	Austria 00:00-22:00	Switzerland 00:00 - 24:00	Liechtenstein 00:00 - 24:00
01.01.	New Years	✔	✔	✔	✔	✔
06.01.	Epiphany			✔		✔
01.05.	May Day	✔	✔	✔		✔
08.05.	Victory Day		✔
14.07.	Bastille Day		✔
01.08.	Swiss National Day				✔
15.08.	Assumption of Mary		✔	✔		✔
08.09	Nativity of Mary					✔
03.10.	The Day of German Unity	✔
26.10.	Austrian National Day			✔
01.11.	All Saints Day		✔	✔		✔
11.11.	Armistice		✔
08.12.	Feats of the Immaculate Conception			✔		✔
25.12.	Christmas Day	✔	✔	✔	✔	✔
26.12.	Day after Christmas	✔		✔		✔

Public holidays with a varying date

Date	Official Name	Germany 00:00 - 22:00	France 00:00 - 22:00	Austria 00:00-22:00	Switzerland 00:00 - 24:00	Liechtenstein 00:00- 24:00
14.17.2017	Good Friday	✔		✔
30.03.2018	Good Friday	✔		✔
19.04.2019	Good Friday	✔		✔
17.04.2017	Easter Monday	✔	✔	✔		✔
02.04.2018	Easter Monday	✔	✔	✔		✔
22.04.2019	Easter Monday	✔	✔	✔		✔
25.05.2017	Ascension Day	✔	✔	✔	✔	✔
10.05.2018	Ascension Day	✔	✔	✔	✔	✔
30.05.2019	Ascension Day	✔	✔	✔	✔	✔
05.06.2017	Whitmonday	✔	✔	✔		✔
21.05.2018	Whitmonday	✔	✔	✔		✔
10.06.2019	Whitmonday	✔	✔	✔		✔
15.06.2017	Corpus Christi			✔		✔
31.05.2018	Corpus Christi			✔		✔
20.06.2019	Corpus Christi			✔		✔

Installation Guide

• Download the latest Feature Layer PTV_GeneralTruckRestrictionsfrom the Customer Area of the PTV Developer Zone according to the used map. If you don't have an account, please contact your account manager at PTV.

• Unzip the PTV_GeneralTruckRestrictions_<Mapname>.zip file directly to the map folder of the PTV xServer. The map folder is specified in the maps.path key of the configuration file <PTV xRoute folder>/conf/xroute.properties

• Restart the PTV xServer to activate the just installed feature layers..

• Use the PTV xRoute Server and activate the PTV_GeneralTruckRestrictions Feature Layer via Profile or Profile XML Snippet within the server request.

Programming Guide

Feature Matrix for Feature Layer: PTV_TruckWaitingTimes

Find out which service method of the PTV xRoute Server supports the PTV_GeneralTruckRestrictions Feature Layer theme.

Use a PTV xRoute request with at least two stations and a start time with a general truck restriction (e.g. truck ban on Sundays) and enable the use of the Feature Layer theme PTV_TruckWaitingTimes by setting the following XML profile snippet in the CallerContext of this request.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Profile xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:noNamespaceSchemaLocation=\"http:///xroute/schema/XRouteProfile.xsd\">
  <Common language='en' majorVersion='1' minorVersion='0'/>
  <Routing majorVersion='2' minorVersion='0'>
    <Course>
      <AdditionalDataRules enabled='true'/>
    </Course>
  </Routing>
  <FeatureLayer majorVersion='1' minorVersion='0'>
    <GlobalSettings enableTimeDependency='true'/>
    <Themes>
      <Theme id='PTV_GeneralTruckRestrictions' enabled='true'>
        <FeatureDescription includeLanguageCode='true'>
          <Property id='message' included='true'/>
        </FeatureDescription>
      </Theme>
    </Themes>
  </FeatureLayer>
</Profile>
		

Below you can find a JSON sample request which can be directly copied and put into the raw request runner of an xRoute Server to be tested.

JSON sample Request: Routing through a general truck restriction (truck ban on Sundays) with the method calculateRoute():

{
  "waypoints": [
    {
      "$type": "WaypointDesc",
      "linkType": "NEXT_SEGMENT",
      "fuzzyRadius": 0,
      "coords": [
        {
          "$type": "Point",
          "point": {
            "$type": "PlainPoint",
            "x": 11.16915,
            "y": 49.46362
          }
        }
      ]
    },
    {
      "$type": "WaypointDesc",
      "linkType": "NEXT_SEGMENT",
      "fuzzyRadius": 0,
      "coords": [
        {
          "$type": "Point",
          "point": {
            "$type": "PlainPoint",
            "x": 14.53603,
            "y": 50.01605
          }
        }
      ]
    }
  ],
  "options": [
    {
      "parameter": "START_TIME",
      "value": "2016-11-20T08:00:00+02:00"
    }
    
  ],
  "exceptionPaths": null,
  "details": {
    "polygon": true,
    "detailLevel": "STANDARD",
    "dynamicInfo": true,
    "segments": true,
    "featureDescriptions": true
  },
  "callerContext": {
    "properties": [
      {
        "key": "CoordFormat",
        "value": "OG_GEODECIMAL"
      },
      {
        "key": "ResponseGeometry",
        "value": "WKB"
      },
      {
        "key": "Profile",
        "value": "truckfast"
      },
      {
        "key": "ProfileXMLSnippet",
        "value": "<Profile xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:noNamespaceSchemaLocation=\"http:///xroute/schema/XRouteProfile.xsd\"><Common language='en' majorVersion='1' minorVersion='0'/><Routing majorVersion='2' minorVersion='0'><Course><AdditionalDataRules enabled='true'/></Course></Routing><FeatureLayer majorVersion='1' minorVersion='0'><GlobalSettings enableTimeDependency='true'/><Themes><Theme id='PTV_GeneralTruckRestrictions' enabled='true'><FeatureDescription includeLanguageCode='true'><Property id='message' included='true'/></FeatureDescription></Theme></Themes></FeatureLayer></Profile>"
      }
    ]
  }
}

				

By setting "dynamicInfo" : "true" in the request you will receive the actual waiting time for the route in the response (timeLoss).

Furthermore you receive detailed information about the blocking on each segment in the featureDescriptions in your response.

Copyright © 2024 PTV Logistics GmbH All rights reserved. | Imprint