/usr/share/routino/www/documentation/output.html is in routino-www 2.4.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML>
<!--
Routino documentation - output
Part of the Routino routing software.
This file Copyright 2008-2012 Andrew M. Bishop
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see http://www.gnu.org/licenses/.
-->
<HEAD>
<TITLE>Routino : Output</TITLE>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<LINK href="style.css" type="text/css" rel="stylesheet">
</HEAD>
<BODY>
<!-- Header Start -->
<div class="header" align="center">
<h1>Routino : Output</h1>
<hr>
</div>
<!-- Header End -->
<!-- Content Start -->
<div class="content">
<h2><a name="H_1_1"></a>Router Output</h2>
There are three different formats of output from the router, HTML,
<a class="ext" title="GPX format" href="http://www.topografix.com/gpx.asp">GPX (GPS eXchange) XML format</a>
and plain text with a total of five possible output files:
<ul>
<li>HTML route instructions for each interesting junction.
<li>GPX track file containing every node.
<li>GPX route file with waypoints at interesting junctions.
<li>Plain text description with the interesting junctions.
<li>Plain text file with every node.
</ul>
The "interesting junctions" referred to above are junctions where the route
changes to a different type of highway, more than two highways of the same type
meet, or where the route meets but does not take a more major highway. When the
route follows a major road this definition eliminates all junctions with minor
roads.
<p>
The output files are written to the current directory and are named depending on
the selection of shortest or quickest route. For the shortest route the file
names are "shortest.html", "shortest-track.gpx", "shortest-route.gpx",
"shortest.txt" and "shortest-all.txt", for the quickest route the names are
"quickest.html", "quickest-track.gpx", "quickest-route.gpx", "quickest.txt" and
"quickest-all.txt".
<p>
The HTML file and GPX files are written out according to the selected language
using the translations contained in the translations.xml configuration file.
The text files contains untranslated header lines (in English) but the data is
translated.
<!-- For reference the examples were produced from the following URL:
http://www.routino.org/uk/router.html?transport=motorcar;lon1=-0.12790;lat1=51.52468;lon2=-0.10365;lat2=51.47824 -->
<h3><a name="H_1_1_1" title="HTML file"></a>HTML Route Instructions</h3>
The HTML route instructions file contains one line for the description of each
of the interesting junctions in the route and one line for each of the highways
that connect them. The coordinates are also included in the file but are not
visible because of the style definitions.
<p>
An example HTML file output is below (some parts are missing, for example the
style definitions):
<pre class="boxed">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML>
<!-- Creator : Routino - http://www.routino.org/ -->
<!-- Source : Based on OpenStreetMap data from http://www.openstreetmap.org/ -->
<!-- License : http://www.openstreetmap.org/copyright -->
<HEAD>
<TITLE>Shortest Route</TITLE>
...
</HEAD>
<BODY>
<H1>Shortest Route</H1>
<table>
<tr class='c'><td class='l'>1:<td class='r'>51.524658 -0.127877
<tr class='n'><td class='l'>Start:<td class='r'>At <span class='w'>Waypoint</span>, head <span class='b'>South-East</span>
<tr class='s'><td class='l'>Follow:<td class='r'><span class='h'>Woburn Place (A4200)</span> for <span class='d'>0.251 km, 0.3 min</span> [<span class='j'>0.3 km, 0 minutes</span>]
<tr class='c'><td class='l'>2:<td class='r'>51.522811 -0.125781
<tr class='n'><td class='l'>At:<td class='r'>Junction, go <span class='t'>Straight on</span> heading <span class='b'>South-East</span>
<tr class='s'><td class='l'>Follow:<td class='r'><span class='h'>Russell Square (A4200)</span> for <span class='d'>0.186 km, 0.2 min</span> [<span class='j'>0.4 km, 1 minutes</span>]
<tr class='c'><td class='l'>3:<td class='r'>51.521482 -0.124123
<tr class='n'><td class='l'>At:<td class='r'>Junction, go <span class='t'>Straight on</span> heading <span class='b'>South-East</span>
<tr class='s'><td class='l'>Follow:<td class='r'><span class='h'>Southampton Row (A4200)</span> for <span class='d'>0.351 km, 0.4 min</span> [<span class='j'>0.8 km, 1 minutes</span>]
...
<tr class='c'><td class='l'>21:<td class='r'>51.477678 -0.106792
<tr class='n'><td class='l'>At:<td class='r'>Junction, go <span class='t'>Slight left</span> heading <span class='b'>South-East</span>
<tr class='s'><td class='l'>Follow:<td class='r'><span class='h'>Vassall Road</span> for <span class='d'>0.138 km, 0.2 min</span> [<span class='j'>6.3 km, 6 minutes</span>]
<tr class='c'><td class='l'>22:<td class='r'>51.478015 -0.104870
<tr class='n'><td class='l'>At:<td class='r'>Junction, go <span class='t'>Straight on</span> heading <span class='b'>East</span>
<tr class='s'><td class='l'>Follow:<td class='r'><span class='h'>Vassall Road</span> for <span class='d'>0.087 km, 0.1 min</span> [<span class='j'>6.4 km, 6 minutes</span>]
<tr class='c'><td class='l'>23:<td class='r'>51.478244 -0.103651
<tr class='n'><td class='l'>Stop:<td class='r'>At <span class='w'>Waypoint</span>
<tr class='t'><td class='l'>Total:<td class='r'><span class='j'>6.4 km, 6 minutes</span>
</table>
</BODY>
</HTML>
</pre>
<h3><a name="H_1_1_2" title="GPX track file"></a>GPX Track File</h3>
The GPX track file contains a track with all of the individual nodes that the
route passes through.
<p>
An example GPX track file output is below:
<pre class="boxed">
<?xml version="1.0" encoding="UTF-8"?>
<gpx version="1.1" creator="Routino" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.topografix.com/GPX/1/1" xsi:schemaLocation="http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd">
<metadata>
<desc>Creator : Routino - http://www.routino.org/</desc>
<copyright author="Based on OpenStreetMap data from http://www.openstreetmap.org/">
<license>http://www.openstreetmap.org/copyright</license>
</copyright>
</metadata>
<trk>
<name>Shortest route</name>
<desc>Shortest route between 'start' and 'finish' waypoints</desc>
<trkpt lat="51.524658" lon="-0.127877"/>
<trkpt lat="51.523768" lon="-0.126918"/>
<trkpt lat="51.522811" lon="-0.125781"/>
...
<trkpt lat="51.478015" lon="-0.104870"/>
<trkpt lat="51.478127" lon="-0.104174"/>
<trkpt lat="51.478244" lon="-0.103651"/>
</trkseg>
</trk>
</gpx>
</pre>
<h3><a name="H_1_1_3" title="GPX route file"></a>GPX Route File</h3>
The GPX route file contains a route (ordered set of waypoints) with all of the
interesting junctions that the route passes through and a description of the
route to take from that point.
<p>
An example GPX route file output is below:
<pre class="boxed">
<?xml version="1.0" encoding="UTF-8"?>
<gpx version="1.1" creator="Routino" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.topografix.com/GPX/1/1" xsi:schemaLocation="http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd">
<metadata>
<desc>Creator : Routino - http://www.routino.org/</desc>
<copyright author="Based on OpenStreetMap data from http://www.openstreetmap.org/">
<license>http://www.openstreetmap.org/copyright</license>
</copyright>
</metadata>
<rte>
<name>Shortest route</name>
<desc>Shortest route between 'start' and 'finish' waypoints</desc>
<rtept lat="51.524658" lon="-0.127877">
<name>START</name>
<desc>South-East on 'Woburn Place (A4200)' for 0.251 km, 0.3 min</desc>
</rtept>
<rtept lat="51.522811" lon="-0.125781">
<name>TRIP001</name>
<desc>South-East on 'Russell Square (A4200)' for 0.186 km, 0.2 min</desc>
</rtept>
<rtept lat="51.521482" lon="-0.124123">
<name>TRIP002</name>
<desc>South-East on 'Southampton Row (A4200)' for 0.351 km, 0.4 min</desc>
</rtept>
...
<rtept lat="51.477678" lon="-0.106792">
<name>TRIP020</name>
<desc>South-East on 'Vassall Road' for 0.138 km, 0.2 min</desc>
</rtept>
<rtept lat="51.478015" lon="-0.104870">
<name>TRIP021</name>
<desc>East on 'Vassall Road' for 0.087 km, 0.1 min</desc>
</rtept>
<rtept lat="51.478244" lon="-0.103651">
<name>FINISH</name>
<desc>Total Journey 6.4 km, 6 minutes</desc>
</rtept>
</rte>
</gpx>
</pre>
<h3><a name="H_1_1_4" title="Text file"></a>Text File</h3>
The text file format contains one entry for all of the interesting junctions in
the route and is intended to be easy to interpret, for example for creating
other output formats.
<p>
An example text file output is below:
<pre class="boxed">
# Creator : Routino - http://www.routino.org/
# Source : Based on OpenStreetMap data from http://www.openstreetmap.org/
# License : http://www.openstreetmap.org/copyright
#
#Latitude Longitude Section Section Total Total Point Turn Bearing Highway
# Distance Duration Distance Duration Type
51.524658 -0.127877 0.000 km 0.0 min 0.0 km 0 min Waypt +3 Woburn Place (A4200)
51.522811 -0.125781 0.251 km 0.3 min 0.3 km 0 min Junct +0 +3 Russell Square (A4200)
51.521482 -0.124123 0.186 km 0.2 min 0.4 km 1 min Junct +0 +3 Southampton Row (A4200)
...
51.477678 -0.106792 0.204 km 0.2 min 6.1 km 5 min Junct +0 +3 Vassall Road
51.478015 -0.104870 0.138 km 0.2 min 6.3 km 6 min Junct +0 +2 Vassall Road
51.478244 -0.103651 0.087 km 0.1 min 6.4 km 6 min Waypt
</pre>
<p>
The text file output contains a header (indicated by the lines starting with
'#') and then one line for each waypoint or junction. Each line contains the
information for the current node and the next segment to be followed.
For each of the lines the individual fields contain the following:
<table>
<tr>
<th>Item
<th class=left>Description
<tr>
<td>Latitude
<td>Location of the node (degrees)
<tr>
<td>Longitude
<td>Location of the node (degrees)
<tr>
<td>Section Distance
<td>The distance travelled on the section of the journey that ends at this
node.
<tr>
<td>Section Duration
<td>The duration of travel on the section of the journey that ends at this
node.
<tr>
<td>Total Distance
<td>The total distance travelled up to this point.
<tr>
<td>Total Duration
<td>The total duration of travel up to this point.
<tr>
<td>Point Type
<td>The type of point; either a waypoint <em>Waypt</em> or junction
<em>Junct</em>.
<tr>
<td>Turn
<td>The direction to turn at this point (missing for the first line since
the journey has not started yet and for the last line because it has
finished). This can take one of nine values between -4 and +4 defined by:
0 = <em>Straight</em>, +2 = <em>Right</em>, -2 = <em>Left</em> and +/-4
= <em>Reverse</em>.
<tr>
<td>Bearing
<td>The direction to head from this point (missing for the last line since
the journey has finished). This can take one of nine values between -4
and +4 defined by: 0 = <em>North</em>, +2 = <em>East</em>, -2
= <em>West</em> and +/-4 = <em>South</em>.
<tr>
<td>Highway
<td>The name (or description) of the highway to follow from this point
(missing on the last line since the journey has finished).
</table>
<p>
The individual items are separated by tabs but some of the items contain spaces
as well.
<h3><a name="H_1_1_5" title="All nodes text file"></a>All Nodes Text File</h3>
The all nodes text file format contains one entry for each of the nodes on the
route.
<p>
An example all nodes text file output is below:
<pre class="boxed">
# Creator : Routino - http://www.routino.org/
# Source : Based on OpenStreetMap data from http://www.openstreetmap.org/
# License : http://www.openstreetmap.org/copyright
#
#Latitude Longitude Node Type Segment Segment Total Total Speed Bearing Highway
# Dist Durat'n Dist Durat'n
51.524658 -0.127877 8439703* Waypt 0.000 0.00 0.00 0.0
51.523768 -0.126918 8439948* Junct- 0.119 0.15 0.12 0.1 96 146 Woburn Place (A4200)
51.522811 -0.125781 8440207* Junct 0.132 0.17 0.25 0.3 96 143 Woburn Place (A4200)
...
51.478015 -0.104870 8529638* Change 0.138 0.17 6.26 5.6 48 74 Vassall Road
51.478127 -0.104174 8529849* Junct- 0.049 0.04 6.31 5.7 64 75 Vassall Road
51.478244 -0.103651 8530008 Waypt 0.038 0.04 6.35 5.7 64 70 Vassall Road
</pre>
<p>
The all nodes text file output contains a header (indicated by the lines
starting with '#') and then one line for each node and the segment that was used
to reach it. This file therefore contains exactly the same model as is used
internally to define a route (a series of results each of which is a node and
the segment leading to it).
For each of the lines the individual fields contain the following:
<table>
<tr>
<th>Item
<th class=left>Description
<tr>
<td>Latitude
<td>Location of the node in degrees.
<tr>
<td>Longitude
<td>Location of the node in degrees.
<tr>
<td>Node
<td>The internal node number and an indicator "*" if the node is a super-node.
<tr>
<td>Type
<td>The type of point; a waypoint <em>Waypt</em>, important
junction <em>Junct</em>, unimportant junction <em>Junct-</em>, change of
highway <em>Change</em> or intermediate node <em>Inter</em>.
<tr>
<td>Segment Distance
<td>The distance travelled on the segment defined on this line.
<tr>
<td>Segment Duration
<td>The duration of travel on the segment defined on this line.
<tr>
<td>Total Distance
<td>The total distance travelled up to this point.
<tr>
<td>Total Duration
<td>The total duration of travel up to this point.
<tr>
<td>Speed
<td>The speed of travel on the segment defined on this line (missing on the
first line).
<tr>
<td>Bearing
<td>The direction that the segment defined on this line travels in degrees
(missing on the first line).
<tr>
<td>Highway
<td>The name (or description) of the highway segment (missing on the first
line).
</table>
</div>
<!-- Content End -->
<!-- Footer Start -->
<div class="footer" align="center">
<hr>
<address>
© Andrew M. Bishop = <amb "at" gedanken.demon.co.uk>
</address>
</div>
<!-- Footer End -->
</BODY>
</HTML>
|