l.1.4.3.source-code.openlr.xsd Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of xml Show documentation
Show all versions of xml Show documentation
OpenLR XML physical format
The newest version!
This schema describes the
XML format for OpenLR location references.
This format includes a
XMLLocationReference but also supports
BinaryLocationReference. The
XMLLocationReference shall make use of the
raw data for any type
so
that no compression techniques are used (e.g.
use of intervals for
the
description of length values). The BinaryLocationReference
shall
represent the compressed format of the location reference.
For further
information on the relevant fields see the OpenLR
white paper at
http://www.openlr.org.
OpenLR is a trade mark of TomTom International
B.V.
author: TomTom International B.V.
The functional road class
is a road classification based
on the importance of a road.
The form of way describes
the physical road type.
The bearing describes the
angle between the true North
and a line. The values range from 0 to
359 degree.
The radius of the circle
area location. The values range
from 0 to max Integer.
A dimension (number of
columns or number of rows) of the
grid area location. The values
range
from 0 to max Short.
The side of the road is
valid only for point locations
and indicates on which side of the
referenced road the
point location is located.
The orientation is only
valid for point locations and
indicates for which direction the point
information is
relevant.
Line attributes describe
features of a line in a network. The
attributes the functional road
class, form of way and the bearing
of a line.
Path attributes describes
features of a path. The LFRCNP attribute
is the lowest functional
road class value which appears in the path.
The highest FRC value is
FRC0 and the lowest possible FRC value
is FRC7.
Coordinates stands for a
pair of WGS84 longitude and latitude
values. This coordinate pair
specifies a geometric point in a
digital map.
The bounding box
describes a rectangle which covers the location
completely. The
rectangle is defined by the coordinates of the
lower left and upper
right corners.
Offsets are used to
shorten the location reference path at its
start and end. The new
positions along the location reference
path indicate the real start
and end of the location. The positive
offset is the difference of the
start point of the location
reference and the start point of the
desired location along the
location reference path. The negative
offset is the difference
of the end point of the desired location and
the end point of the
location reference along the location reference
path. Both values
are measured in meter.
The LocationName provides
information in order to generate a
proper human-readable name. It may
contain different building blocks or a
compressed name. The following
building blocks may be provided:
fromArea = area name where the
location starts,
toArea = area name where the location ends,
roadName
= list of road names along the location,
start = concrete start
point
of the location,
end = concrete end point of the location.
AdditionalData can be
used to add any other kind of information
needed like debug
information or additional encoder/decoder flags.
AdditionalInformation can
be added if necessary. This includes
the bounding box covering the
location and information on the map
used
for encoding. The
AdditionalData section also provides the freedom
to add any other
information needed.
The basis of a location
reference is a sequence of location
reference points (LRPs). Such a
LRP contains a coordinate pair,
specified in WGS84 longitude and
latitude values and additionally
several line
and path attributes.
The sequence of location
reference points is terminated by a last
location reference point.
This LRP does not need to have any
path attributes.
The
BinaryLocationReference is the Base64-encoded binary representation
of the location reference. Each binary location reference needs
to
have an identifier and a version. The version is defined by the
version of the binary physical format.
A LineLocationReference
is defined by an ordered sequence of
location reference points and a
terminating last location
reference point.
A LineLocationReference
is defined by an ordered sequence of
location reference points and a
terminating last location
reference point.
GeoCoordinate is a point
location which consists of exactly one
coordinate pair.
Point along line is a
point location which is defined by a line
and an offset value. The
line will be referenced by two location
reference points and the
concrete position on that line is
referenced
using the positive
offset. Additionally information about the side of
the road where the
point is located and the orientation with respect
to the direction of
the line can be added.
Point along line with
access is a point location which is defined by
a line, an offset
value and a coordinate. The line will be
referenced by two location
reference points and the concrete position
of the access point on
that line is referenced using the positive
offset. The point of
interest is identified by the coordinate pair.
Additionally
information about the side of the road where the point
is located and
the orientation with respect to the direction of the
line can be
added.
A PointLocationReference
represents a point of interest. The point may
be bound to the
underlying network.
An AreaLocationReference
represents a set of area location like circle polygon rectangle and
grid location.
A CircleLocationReference
represents a circle area location. The circle area may
be bound to
the
underlying network.
A
RectangleLocationReference
represents a rectangular area location.
A GridLocationReference
represents a rectangular area location
with a
grid of
ncols
columns and
nrows
rows.
A
PolygonLocationReference
represents a polygonal area location
It may exist several
different formats for binary location references
and all formats or a
subset can be included.
A XMLLocationReference
describes an OpenLR location reference. It is configured to
support
line and point as well as area location.
An OpenLR location
reference consists of a unique identifier and
a location reference as
a XMLLocationReference, BinaryLocationReference
or both. The schema
accepts OpenLR tags without any location reference
but these tags
will be ignored.
The XMLLocationReference shall make use of the
raw
data for any type so that no compression techniques are used (e.g.
use of intervals for the description of length values). The
BinaryLocationReference shall represent the compressed format of
the
location reference. If both types are used the location
reference
must represent the same location.
Additional information may be
added
if necessary.