Defines the coordinate format.
PTV representation of coordinates according to the Mercator
projection. Example: x=917420, y=6227729.
PTV representation of longitude/latitude coordinates as
OG_GEODECIMAL coordinates multiplied by 100000. Example: x=825056,
y=4876278.
PTV representation of longitude/latitude coordinates in
degrees (d), minutes (m) and seconds (s) as a single integer number (d *
100000 + m * 1000 + s * 10) multiplied by sign. Example: x=815020, y=4845460
(x represents 8d 15m 2s).
PTV internal coordinate format. Example: x=4352286,
y=5456405.
Longitude/latitude coordinates in decimal degrees [°].
Example: x=8.2505556, y=48.7627778.
Defines a language through a language code according to the BCP 47
standard track defined by the Internet Engineering Task Force (IETF). For most cases
the ISO 639-1 code suffices, region subtypes such as "en-US" are not supported.
Examples: "en" for English or "de" for German. Note that it depends on the data
whether or not texts are available in the given language.
Defines common parameters.
The language used to export texts and geographic names. See
documentation of the type Language for more information.
Defines the format for coordinates defined in this XML schema. For
example, the coordinates of the type Rectangle have to be specified in this
format. Note that all other coordinates not specified in an XML document based
on this schema, for example start and destination coordinates of a route
request, can be specified in a different format.
The major version of the Common element.
The minor version of the Common element.
Defines the type used for dimensions. For example, the width or height
of a vehicle.
Defines a rectangle.
The x-coordinate of the left border.
The y-coordinate of the top border.
The x-coordinate of the right border.
The y-coordinate of the bottom border.
Defines a country. This numeric code is PTV-specific and is usually
the international dialing code of the country. Big countries may be split into
several integration units; in this case both the code of the whole country and the
integration unit codes can be used here.
Defines a country. This numeric code is PTV-specific and is usually
the international dialing code of the country. Big countries may be split into
several integration units; in this case both the code of the whole country and the
integration unit codes can be used here. The special value "*" defines every
country.
Defines a percent value 0 <= x <= 100.
Defines the low-emission zone type of the vehicle.
The vehicle has no low-emission zone type (cannot drive into
red, yellow and green zones).
The red type (a vehicle cannot drive into yellow and green
zones).
The yellow type (a vehicle cannot drive into green
zones).
The green type (a vehicle is allowed to drive in all
zones).
Defines an angle in degrees [°].
Defines the type used for expressing distances.
Defines Mapmatching parameters.
Defines parameters to configure the crawling
algorithm.
The factor which is specified by this
option is used to calculate the range in which the crawling
algorithm operates. The crawling is done in a certain range which is
calculated by multiplying 'movingDistanceRangeFactor' with the
moving distance and substracting it from the moving distance to
determine the lower range bound, and adding it to the moving
distance to determine the upper range bound.
If the calculated lower crawling
range bounds (in meters) as described in 'movingDistanceRangeFactor'
is smaller than the 'movingDistanceRangeMinimum' as specified by
this option, this 'movingDistanceRangeMinimum' is used instead.
Distance in meters.
If the calculated upper crawling
range bounds (in meters) as described in 'movingDistanceRangeFactor'
is larger than the 'movingDistanceRangeMaximum' as specified by this
option, this 'movingDistanceRangeMaximum' is used instead.
This option specifies the maximum
number of passed junctions during the crawling process. Only paths
which passed less junctions than this are considered during
crawling.
It can be specified if junctions in
tunnels will be also counted or not. Setting the parameter to true
can be helpful to avoid long running requests if the parameter
'maximumCrawlingLoopCount' is not strong enough.
This option specifies the maximum
number of passed loops during the crawling process. Only paths which
passed less loops than this are considered during crawling.
The loop limitation can be switched
only for tunnel segments or for all net segments.
Enlarge the search
range. Enables special handling for turn detection. If the vehicle
is turning the maximum crawling range is prolonged, meaning that
additional candidates will be created even if the normal maximum
crawling range is exceeded.
U-turns are allowed when the vehicle
is turning. All streets around the vehicle will be considered in the
crawling algorithm. As well the streets which lay behind the vehicle
and were probably passed by it before. As well the streets which
have not the same direction as the considered heading of the
vehicle.
The A* algorithm is used to improve
the runtime. All paths are skipped, if they can no more lead to
valid candidates because of the airline distance to the link radius
around the destination.
The factor which is specified by this
option is used to weak the A* calculation.
Defines parameters of the weights to find
candidate locations based on the raw location and the possible route. The
sum of all ratings divided by the sum of all weights will result in a value
between 0.0 and 1.0 which is named "local rating". The
(effective) heading difference weight can be calculated dynamically for each
position with respect to its speed. During slow movement, the given heading
from a GPS signal may deviate strongly from the actual heading,
so if the input position provides a low speed, the influence of the heading
difference in the final rating can be reduced. Therefore a
normal velocity can be provided as a "reference" speed for which the
effective weight is to equal the normal heading difference weight. If the
speed decreses, the effective weight decreases as well, and if
the speed increases, the effective weight increases, too. To avoid too
extreme variations in the weight, the range is bounded by
configurable minimum and maximum values. All other weights are
fixed to a single value, that can be configured directly.
This element specified
parameters for the dynamic calculation of the heading difference
weight.
This option
specifies the velocity in meters per second which is
used as base velocity to compute the ratio to the actual
velocity in a position. The normal velocity is the
velocity for which the effective heading difference
weight equals the normal heading difference weight. If
the velocity is lower (or higher), the effective weight
will be lower (or higher, respectively) as well, bounded
by a configurable minimum and maximum value.
The linking distance, meaning the
distance between a candidate location and the raw location, is rated
for each candidate using the rating function as described in
interpolation points for distance rating.
The heading difference, meaning the
difference between the candidate's heading and the current raw
location's heading in degrees, is rated for each candidate using the
rating function as described in Interpolation points for angle
rating. Must not be set if
headingDifferenceRatingMinimum, headingDifferenceRatingNormal,
headingDifferenceRatingMaximum or
HeadingDifferenceRatingParameters/normalVelocity are set.
The heading difference, meaning the
difference between the candidate's heading and the current raw
location's heading in degrees, is rated for each candidate using the
rating function as described in Interpolation points for angle
rating. This attribute specifies the minimal weight
of the heading difference for the local rating of a matched
location. It is the lower bound for the effective heading difference
weight (recalculated for each position a formula depending on speed)
which considers the heading tolerance of a candidate. The calculated
heading difference weight never falls below the value of this
minimal heading difference weight.
The heading difference, meaning the
difference between the candidate's heading and the current raw
location's heading in degrees, is rated for each candidate using the
rating function as described in Interpolation points for angle
rating. This option specifies the normal weight of
the heading difference for the local rating of a matched location.
It is part of the formula to calculate the effective heading
difference weight (recalculated for each position) which considers
the heading tolerance of a candidate. The effective heading
difference weight can't be greater than the maximal heading
difference weight and can't be less than the minimal heading
difference weight. If the driven velocity is equal
to the normal velocity, the heading difference weigth is equal to
the normal heading difference weight.
The heading difference, meaning the
difference between the candidate's heading and the current raw
location's heading in degrees, is rated for each candidate using the
rating function as described in Interpolation points for angle
rating. This attribute specifies the maximal weight
of the heading difference for the local rating of a matched
location. It is the upper bound for the effective heading difference
weight (recalculated for each position by a formula depending on
speed) which considers the heading tolerance of a candidate. The
calculated heading difference weight never exceeds the value of this
maximal heading difference weight.
The transition rating, meaning a
quality rating of the driven distance of a candidate relative to the
driven distance given by the raw location, is calculated for each
candidate using the rating function as described in Interpolation
points for transition rating.
The raw location quality of all
candidates in a history element is considered for the calculation of
the local rating. The raw location quality, which ranges from 0.0 to
1.0, may for example be the quality of a GPS position. The GPS
position's quality is bad if there were fewer satellites available
for positioning and is good if there are many satellites available.
Other location providers may always have a position quality of 1.0.
In some cases a reduced heading
difference weighting is used for the angle rating of the local
rating.
History consideration is used to trace back a
possible driven route based on the specified TrackPositions. Consecutive
candidates of a list of possible pathes will be stored in the history. For a
new possible candidate all pathes will be considered. This is called global
matching. When this feature is turned off, all trackPositions are matched
local only, meaning that the mapmatcher will not try to reconstruct a driven
route but only matches each position to the map by itself.
The best path should be
signaled on a history loss or at the end of a track if it is
good enough.
Determines whether the
best path should be signaled on a history loss or at the
end of a track if it is good enough.
The minimal ratio between
the two best paths, to determine whether the best is
sufficiently better than the alternatives.
To get the best path the ratio has to be better
(greater) or equal than this minimal ratio. To get
always the best path the minimal ratio has to be 1.0.
History consideration is used to
trace back a possible driven route based on the specified
TrackPositions. Consecutive candidates of a list of possible pathes
will be stored in the history. For a new possible candidate all
pathes will be considered. This is called global matching. When this
feature is turned off, all trackPositions are matched local only,
meaning that the mapmatcher will not try to reconstruct a driven
route but only matches each position to the map by itself.
The maximum
number of attempts to redo a history matching if previous history
matchings failed. If no succesful global matching
can be done, the mapmatcher will at this position start over again
with a clean history. Usually this leaves a gap in the matched
track.
The maximum number of elements in the
history. They will be used for the calculation of the positions. The
higher the value the higher the need of memory. Note that the
minimum value for this setting is 3!
Each potential candidate during map
matching is rated. Only the best potential candidates are kept and
made to real candidates while the rest of them are discarded. This
option specifies many of the best-rated candidates are kept.
A number of consecutive candidates on
one possible path are stored in the history. This value limits the
number of candidates with a bad quality. The size of the history
increases by this value.
Enables the possibility to
save all predecessor matched locations if they are merged into the
successors. This functionality only applies, if the limit of the
history elements is reached. No matched location will be removed of
the history.
Defines geometric devitations between the specified
TrackPositions and a potential candidate.
Please note that the parameter
will be only used for enabled history consideration (global
matching). If no history is
present (history lost), the next position is matched locally
with the usual (un-extended) linking radius.
If this match is successful, the linking radius is extended
(with an initial value) and the local matching is repeated with
the new radius. For the next positions, with
each position the linking radius extension is decreased by the
respective distance estimations until it
reaches 0. While the linking radius is extended, there is no
reduction of paths based on the rating, and no
minimal distance between candidates. Using
the linking radius extension, further segments can be found
during the local matching, which increases the
chance to find the correct one, especially after driving
off-road (e.g. on private ground, or outside
of the map data area).
Determines
whether the linking radius is extended after history
lost.
The initial
linking radius extension in meters, which is used to
extend the linking radius after the first local matching
was successful.
The maximum distance in meters
between the specified TrackPosition and a potential candidate. The
position of the potential candidate is the linked position to a
segment of the map.
The maximum angle difference in
degrees of the heading between the specified TrackPosition and a
potential candidate.
The speed up to which a vehicle is
considered to be standing still in meters per second (m/s). If the
speed is below this threshold the vehicle is considered to be
standing still. If the speed is above this threshold, it is
considered to be moving.
Each potential candidate during map
matching is rated which results in the path rating. The path rating
specifies the rating of the path that starts at the last stable
position and ends at the current candidate. The quotient specified
by this option is the maximum accepted quotient between the best
candidate's path rating and another candidate's path rating. If the
quotient is above 'maximumPathRatingQuotient', the potential
candidate is discarded.
Defines the parameter that control whether the
route restrictions could be broken (violated).
The consideration of
blocking information. Blocking information is used during map
matching for blocked streets/roads and for one-way streets. Only
those roads which are allowed to be driven on in the respective
direction are considered.
The consideration of turning bans.
The major version of the Mapmatching element.
The minor version of the Mapmatching element.
For each candidate of an element a probability is
calculated using the local rating of this candidate. Local rating is if the
probability of one point will be considered allone without other points. Only if
the probability of a candidate is above a certain threshold this candidate is
signaled. The best candidate (the candidate with the best local rating) also
receives a bonus to its local rating before said calculation is done. This
option specifies the bonus which is added to the best candidate's local rating.
For each candidate of an element a probability is
calculated using the local rating of this candidate. Only if the probability of
a candidate is above a certain threshold this candidate is signaled.
The root element of the profile.
Defines common parameters.
Defines Mapmatching parameters.
The parent profile.
The data compatibility version.