Hikingbook.pl

Contents 1 Introduction 2 Pictures 3 Samples 3.1 Real World 3.1.1 Atlas 3.1.2 Germany/Taunus 3.1.3 Other 3.2 Experimental 4 Features 5 Parameters and options (v0.98) 5.1 Invocation 5.2 Step information file example 5.3 Description file example 6 Progress 7 Todo / Ideas 8 Installation 8.1 Needed 8.2 Source

Introduction

This program will create hiking books out of osm files. These are multi-page maps with overview and detail pages following the route of one relation in the data. An elevation profile will be added if elevation data is provided for used nodes. See also Wanderbuch.

It is also possible to create a complete atlas of an area - independent of any relation/route. These are pages of maps that connect to each other, complete with overview map, POI and street directory.

If you'd like to have a book of your tour and are not willing to set up all the needed tools, just contact Gary68. Please provide location and relation ID. It should be possible to provide your tour!

See Hikingbook.pl/How for detailed functionality of program.

Pictures

Samples

Real World

Atlas

• Hofheim am Taunus

Germany/Taunus

• Taunusklub Route 15
• File:TaunusklubRoute16SRTM.pdf (inkl. SRTM contour data and elevation profile)
• Taunusklub Route 17
• Taunusklub Route 18
• Taunusklub Route 19
• Taunusklub Route 21
• Taunusklub Route 23

Other

• File:Tiergartentunnel-Wanderweg.pdf (TOPO Style, additional elevation contours made with GroundTruth)
• File:Route16.pdf - Taunusklub Route 16 (hiking style) - Step by step description of process for file File:Route16.pdf: Hikingbook.pl/Process

Experimental

• File:Hikingbook06.pdf
• File:HikingbookSwitzerland05.pdf
• File:Hikingbook04.pdf
• File:Hikingbook03.pdf File:Hikingbook02.pdf File:Hikingbook01.pdf

Features

• Maps along a route
• Atlas creation
• Title page
• Step by step directions with distance, elevation, street names and other POI information
• Overview map
• Elevation profile (out of node data ele-tag and srtm data if present)
• Detail maps (with autorotate optionally)
• POI directory
• Street directory
• OSM file input
• PDF output
• Optional text description by user
• Optional additional texts for step description

Parameters and options (v0.98)

Invocation

perl hikingbook.pl -in=in.osm -out=route.pdf -relation=12345
perl hikingbook.pl -in=in.osm -out=atlas.pdf -atlas=8,50,9,51 -scale=50000

Add parameters and options to your liking:

-in=<infile.osm>
-out=<outfile.pdf>
-relation=<relation id>
-name=<relation name>
-ref=<relation ref>
-atlas=FLOAT,FLOAT,FLOAT,FLOAT (create street atlas for bounding box)
-detailstyle=<mapgen rules file for detail maps>
-overviewstyle=<mapgen rules file for overview maps>
-scale=<integer> (scale for detail maps); default = 10000

-language=EN|DE
-title="title text" (for title page)
-desc=<tex file> (for long text after title page; tex format, max heading subsection
-steps=<step description file> (for descriptions of single steps or nodes; format: stepNr<space>TEXT)
-poi=<integer> (add poi directory to description, specify column number like 1,2,3)
-street=<integer> (add street directory to description, specify column number like 1,2,3)
-dirnumber=4|8 (4 or 8 different directions like N, S, E, W...); default=8
-lesssteps=INTEGER (reduce number of steps in description, step only if direction change > integer degrees)
-stepsize=INTEGER (size of step disc in map; 0 will suppress discs and labels)
-stepcolor=TEXT (color of step disc in map)
-stepfontsize=INTEGER (size of label for step disc in map)

-pagesize=A4|A5
-overlap=<percent> (10 for 10% overlap on each side; default=5)
-pnsizeoverview=INTEGER (size of page numbers in overview map)
-pnsizedetail=INTEGER (size of page numbers in detail maps)
-landscape
-autorotate (rotate paper format automatically)

-reverse (reverse direction of relation/route)
-roundtrip (force route to begin/end with first way in relation)

-verbose
-nodelete (temp files will not be deleted)
-help

Step information file example

1 here we go
10 a long way to go
20 soon we are there

Description file example

\subsection*{Part 1 of the way}
some text here.
\subsection*{Part 2 of the way}
more text...

Progress

• defaults for title and outFileName (v0.94)
• roles of ways are checked now (v0.94)
• elevation data will be extracted from srtm data if present in osm file (0.96)
• street directory (v0.97)
• Atlas creation (v0.98)

Todo / Ideas

• missing elements details only in verbose mode
• gpx file as route instead of relation
• -large=INTEGER (would only draw cities, towns etc. - depending on level - in overview map) This would enable the program to create real large books with many many pages (large areas)
• support tile server for map generation (no suitable solution found yet. taho.pl would be best, but still lots of shortcomings)
• a5 support (problems with latex; map generation ok)
• program that explicitly lists all valid hiking relations of one osm file (and creates hiking books)
• Maperitive support

Hikingbook.pl/Other Ideas

Installation

Needed

• Mapgen.pl
• gs (ghostscript)
• latex (latex, dvips, ps2pdf)
• Osmosis
• pdfjoin (package pdfjam)

Source

• hikingbook.pl
• hikingbook.poi (holds POIs to be added to description. key,value,maxDist,TextEN,TextDE)
• hikingRules.csv

perl hikingbook.pl -help