summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/getmap
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-08-12 21:41:30 +0000
committerKarl Berry <karl@freefriends.org>2014-08-12 21:41:30 +0000
commitca4c4b70f17ec42f8267024b244a185769efd9d1 (patch)
treeaef1aa9175fb3421c081a891378b6fab369e1648 /Master/texmf-dist/doc/latex/getmap
parent666535e53fe160d45e038feb00c7d348809d9a6e (diff)
getmap (12aug14)
git-svn-id: svn://tug.org/texlive/trunk@34917 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/getmap')
-rw-r--r--Master/texmf-dist/doc/latex/getmap/README14
-rw-r--r--Master/texmf-dist/doc/latex/getmap/getmap.dtx136
-rw-r--r--Master/texmf-dist/doc/latex/getmap/getmap.pdfbin1697615 -> 1764654 bytes
-rwxr-xr-xMaster/texmf-dist/doc/latex/getmap/install.bat3
-rw-r--r--Master/texmf-dist/doc/latex/getmap/makefile5
-rw-r--r--Master/texmf-dist/doc/latex/getmap/manifest.txt1
6 files changed, 137 insertions, 22 deletions
diff --git a/Master/texmf-dist/doc/latex/getmap/README b/Master/texmf-dist/doc/latex/getmap/README
index ecc89af94ff..a11a0068849 100644
--- a/Master/texmf-dist/doc/latex/getmap/README
+++ b/Master/texmf-dist/doc/latex/getmap/README
@@ -8,17 +8,15 @@ use this script also from the command line.
License: LPPL
-Changes in v1.4:
+Changes in v1.5:
-- added new options in gm mode
+- added gpx2gps bash file
- * language (language of map labels)
- * markers (set marker on map)
- * visible (ensure locations to be on the map)
- * path (draw pathes and routes)
- * pathfile (load complicated encoded polylines (routes))
+ transforms a gpx file (exported route) into a plain list
+ of geographical coordinates (latitude,longitude) to create
+ an encoded polyline (route) for the map
-- added more examples to the documentation
+- updated documentation
INSTALL
===========
diff --git a/Master/texmf-dist/doc/latex/getmap/getmap.dtx b/Master/texmf-dist/doc/latex/getmap/getmap.dtx
index 1ec2fec9715..ab20a47c83a 100644
--- a/Master/texmf-dist/doc/latex/getmap/getmap.dtx
+++ b/Master/texmf-dist/doc/latex/getmap/getmap.dtx
@@ -14,17 +14,15 @@ use this script also from the command line.
License: LPPL
-Changes in v1.4:
+Changes in v1.5:
-- added new options in gm mode
+- added gpx2gps bash file
- * language (language of map labels)
- * markers (set marker on map)
- * visible (ensure locations to be on the map)
- * path (draw pathes and routes)
- * pathfile (load complicated encoded polylines (routes))
-
-- added more examples to the documentation
+ transforms a gpx file (exported route) into a plain list
+ of geographical coordinates (latitude,longitude) to create
+ an encoded polyline (route) for the map
+
+- updated documentation
INSTALL
@@ -90,6 +88,13 @@ download getmap.dtx and makefile (Linux) or install.bat (Windows)
title = {{Static Map Service: Standard Icons}},
year = {2014},
}
+
+@misc{bib:mapquestopenlatlngencdec,
+ author = {{MapQuest, Inc}},
+ note = {\href{http://open.mapquestapi.com/common/encodedecode.html}{http://open.mapquestapi.com/common/encodedecode.html}},
+ title = {{Compressed Lat/Lng Encoding/Decoding}},
+ year = {2014},
+ }
@misc{bib:googlemapsapi,
author = {{Google, Inc.}},
@@ -119,6 +124,13 @@ download getmap.dtx and makefile (Linux) or install.bat (Windows)
year = {2014},
}
+@misc{bib:orsorg,
+ author = {{OpenRouteService.org}},
+ note = {\href{http://openrouteservice.org}{http://openrouteservice.org}},
+ title = {{Routing with user-generated, collaboratively collected free geodata.}},
+ year = {2014},
+ }
+
%</bibfile>
%<*luafile>
#!/usr/bin/env texlua
@@ -653,8 +665,51 @@ getmap.sty
getmap.cfg
getmap-example.tex
getmapdl.lua
+gpx2gps
manifest.txt
%</manifest>
+%<*gpx2gps>
+#!/bin/bash
+#
+# gpx2gps file.gpx
+#
+# parses file.gpx and outputs a list of
+# geographical coordinates latitude,longitude
+#
+# License: LPPL
+#
+filename="$1"
+version="v1.0 (12/08/2014)"
+#
+usage()
+{
+ echo -e "Usage: `basename $0` file.gpx"
+ echo -e "Version: $version"
+ exit 1
+}
+#
+if [ -z "$filename" ]
+then
+ usage
+fi
+if [ "$filename" = "-h" ]
+then
+ usage
+fi
+if [ ! -e "$filename" ]
+then
+ echo -e "File $filename does not exist!"
+ exit 2
+fi
+#
+for line in `grep -e "<trkpt" $filename | tr ' ' '+'`
+do
+ latitude=`echo "$line" | sed -e 's#.*lat="\(.*\)".*#\1#' -e 's#".*$##'`
+ longitude=`echo "$line" | sed -e 's#.*lon="\(.*\)".*#\1#' -e 's#".*$##'`
+ echo "$latitude,$longitude"
+done
+exit 0
+%</gpx2gps>
%<*internal>
\fi
\def\nameofplainTeX{plain}
@@ -721,6 +776,9 @@ This work consists of all files listed in manifest.txt.
\generate{
\file{getmapdl.lua}{\from{\jobname.dtx}{luafile}}
}
+\generate{
+ \file{gpx2gps.sh}{\from{\jobname.dtx}{gpx2gps}}
+}
\ifx\fmtname\nameofplainTeX
\expandafter\endbatchfile
\else
@@ -858,7 +916,6 @@ emph={}}
\gdef\and{\unskip{}, }%
\newcommand\doubledash{-\kern0.5pt-}
\def\enoteformat{\rightskip\z@ \leftskip\z@ \parindent=1em\leavevmode\llap{\makeenmark}}
-\def\filename{logicpuzzle.sty}%
\def\XeLaTeX{Xe\LaTeX}%
%
\newenvironment{optionlist}
@@ -1127,7 +1184,7 @@ visible={Brandenburger Tor, Berlin|Reichstagsufer 1, Berlin}]{}
%</example>
% \fi
% \subsubsection{\texttt{path}}
-% With this option you can define one or more pathes! It expects one or more URL parameters like:
+% With this option you can define one or more paths! It expects one or more URL parameters like:
%
% \texttt{\&path=weight:5\textbar{}color:orange\textbar{}loc1\textbar{}loc2\textbar{}...}
%
@@ -1161,7 +1218,7 @@ path={&path=weight:5|color:orange|Bode Museum, Berlin|%
% Weinmeisterstraße 6, Berlin}]{}
% \includegraphics[width=10cm]{bmus3}
%
-% You can also use \texttt{fillcolor} to mark areas! In pathes, you
+% You can also use \texttt{fillcolor} to mark areas! In paths, you
% can also specify RGB32 colors, in which the last byte defines opacity,
% e.g. 55 (33\%).
%
@@ -1226,6 +1283,58 @@ pathfile={muc.epl}]{}
%</example>
% \fi
%
+% You can also use an OpenStreetMap based route service\footnote{\href{http://openrouteservice.org}{http://openrouteservice.org}}
+% to create your route and export it to a \texttt{gpx} file\footnote{This also means that you can visualize your own routes tracked with hardware or a software app!}.
+% It's basically a xml-packaged list of geographical coordinates.
+% You can use the following one liner\footnote{The attached \texttt{gpx2gps} \texttt{bash} script does the same in a more general way} to clean the file:
+% \clearpage
+% \iffalse
+%<*example>
+% \fi
+\begin{lstlisting}
+grep -e 'trkpt' file.gpx | sed -e 's/^.*lon="//' -e 's/" lat="/,/'
+-e 's#"/>##' | sed -e 's/^\([^,]*\),\([^,]*\)/\2,\1/' >file.txt
+\end{lstlisting}
+% \iffalse
+%</example>
+% \fi
+% First, we grep the track point lines, clean the xml parts and finally
+% change the order of latitude and longitude.
+% Thus, you have a clean list of geographical coordinates, which you can
+% copy and paste into this
+% \href{http://open.mapquestapi.com/common/encodedecode.html}{Mapquest web service}\footnote{\href{http://open.mapquestapi.com/common/encodedecode.html}{http://open.mapquestapi.com/common/encodedecode.html}}
+% to get an encoded polyline!
+%
+% \begin{filecontents*}{berlin.epl}
+% &path=weight:5|color:purple|enc:_xq_IcgrpA?AFE@?^BFE@A^U@CLQXEZU?gCR?B?DBF@@?vA?D?D?BAHE@JBN@JLGFCG[DC~C?@?F?R?vA?p@iB@i@Fe@JWRSTOf@Gh@C^A?e@?gE?w@r@?lB@hA?`@??M?aA?]dI??O?O?Cn@cBfBeF|AeEHNVNBc@H@H_AEwA?OAMNA@N
+% \end{filecontents*}
+% \getmap[file=berlin, mode=gm, language=de, xsize=400, ysize=600,
+% markers={&markers=size:mid|label:H|color:green|Berlin, Hbf
+% &markers=label:B|color:blue|Brandenburger Tor, Berlin},
+% pathfile={berlin.epl}]{}
+% \includegraphics[width=6cm]{berlin}
+% \iffalse
+%<*example>
+% \fi
+\begin{lstlisting}
+\begin{filecontents*}{berlin.epl}
+&path=weight:5|color:purple|enc:_xq_IcgrpA?AFE@?^BFE@A^U@CLQXEZU?%
+gCR?B?DBF@@?vA?D?D?BAHE@JBN@JLGFCG[DC~C?@?F?R?vA?p@iB@i@Fe@JWRSTO%
+f@Gh@C^A?e@?gE?w@r@?lB@hA?`@??M?aA?]dI??O?O?Cn@cBfBeF|AeEHNVNBc@H%
+@H_AEwA?OAMNA@N
+\end{filecontents*}
+\getmap[file=berlin, mode=gm, language=de, xsize=400, ysize=600,
+markers={&markers=size:mid|label:H|color:green|Berlin, Hbf
+ &markers=label:B|color:blue|Brandenburger Tor, Berlin},
+pathfile={berlin.epl}]{}
+\includegraphics[width=6cm]{berlin}
+\end{lstlisting}
+% \iffalse
+%</example>
+% \fi
+%
+% Please note that the length of the URL is limited to 2048 bytes. So, there's
+% no way to support extreme long paths!
% \subsection{\texttt{gsv} mode}
% \subsubsection[\texttt{xsize}]{\texttt{xsize (\underline{600})}}
% This option specifies the width of the map in pixels. (max: 640)
@@ -1367,13 +1476,14 @@ pathfile={muc.epl}]{}
% \changes{v1.2}{2014/07/11}{renamed osmimage.lua to getmapdl.lua}
% \changes{v1.3}{2014/07/19}{added support for Google Street View}
% \changes{v1.4}{2014/07/25}{added options language, markers, visible, path and pathfile in gm mode}
+% \changes{v1.5}{2014/08/12}{added \texttt{gpx2gps} \texttt{bash} script}
% \begin{macrocode}
%<*package>
% \end{macrocode}
% First, we provide the \LaTeX\ package \package{getmap}.
% \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}%
-\ProvidesPackage{getmap}[2014/07/25 v1.4 getmap.sty - Josef Kleber (C) 2014]%
+\ProvidesPackage{getmap}[2014/08/12 v1.5 getmap.sty - Josef Kleber (C) 2014]%
% \end{macrocode}
% We need a few packages!
% \begin{macrocode}
diff --git a/Master/texmf-dist/doc/latex/getmap/getmap.pdf b/Master/texmf-dist/doc/latex/getmap/getmap.pdf
index ebcc99dd173..c50734cdcf3 100644
--- a/Master/texmf-dist/doc/latex/getmap/getmap.pdf
+++ b/Master/texmf-dist/doc/latex/getmap/getmap.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/getmap/install.bat b/Master/texmf-dist/doc/latex/getmap/install.bat
index d9c5fb9092e..e767153359b 100755
--- a/Master/texmf-dist/doc/latex/getmap/install.bat
+++ b/Master/texmf-dist/doc/latex/getmap/install.bat
@@ -19,9 +19,11 @@ makeindex -q -s gind.ist %pckname% >nul
makeindex -q -s gglo.ist %pckname%.glo -o %pckname%.gls >nul
pdflatex %pckname%.dtx >nul
ren README.txt README >nul
+ren gpx2gps.sh gpx2gps >nul
echo Copying files to %texmfpath%
md %texmfpath%\scripts\%pckname% >nul
copy getmapdl.lua %texmfpath%\scripts\%pckname%\ >nul
+copy gpx2gps %texmfpath%\scripts\%pckname%\ >nul
md %texmfpath%\tex\latex\%pckname% >nul
copy *.sty %texmfpath%\tex\latex\%pckname% >nul
copy *.cfg %texmfpath%\tex\latex\%pckname% >nul
@@ -55,6 +57,7 @@ del *.png
del *.jpg
del *.epl
del getmapdl.lua
+del gpx2gps
del README
del getmap.pdf
echo Create getmapdl.exe
diff --git a/Master/texmf-dist/doc/latex/getmap/makefile b/Master/texmf-dist/doc/latex/getmap/makefile
index 322429c3e0d..f5ebcf3f64a 100644
--- a/Master/texmf-dist/doc/latex/getmap/makefile
+++ b/Master/texmf-dist/doc/latex/getmap/makefile
@@ -21,6 +21,7 @@ $(PKGNAME).pdf:
package:
pdftex $(PKGNAME).dtx
mv README.txt README
+ mv gpx2gps.sh gpx2gps
install: doc
mkdir -p ${TEXMF}/doc/latex/${PKGNAME}
@@ -34,6 +35,7 @@ install: doc
cp *.cfg ${TEXMF}/tex/latex/${PKGNAME}/
mkdir -p ${TEXMF}/scripts/${PKGNAME}
cp getmapdl.lua ${TEXMF}/scripts/${PKGNAME}/
+ cp gpx2gps ${TEXMF}/scripts/${PKGNAME}/
texhash
chmod 0755 ${TEXMF}/scripts/${PKGNAME}/getmapdl.lua
ln -s ${TEXMF}/scripts/${PKGNAME}/getmapdl.lua ${BINDIR}/getmapdl
@@ -50,6 +52,7 @@ styles: package
git: package
cp getmapdl.lua ./../dev/scripts/getmap/getmapdl.lua
+ cp gpx2gps ./../dev/scripts/getmap/gpx2gps
cp getmap.sty ./../dev/tex/latex/getmap/getmap.sty
cp getmap.cfg ./../dev/tex/latex/getmap/getmap.cfg
@@ -62,7 +65,7 @@ clean:
*.bbl *.blg *.ins *.txt *.bib *.epl
cleanall: clean
- $(RM) getmapdl.lua *.sty *.png *.jpg\
+ $(RM) getmapdl.lua gpx2gps *.sty *.png *.jpg\
*.cfg *.tex README getmap.pdf
.PHONY: all doc package install uninstall styles git ctan clean cleanall
diff --git a/Master/texmf-dist/doc/latex/getmap/manifest.txt b/Master/texmf-dist/doc/latex/getmap/manifest.txt
index b7f6f9043b6..c7b1b61918b 100644
--- a/Master/texmf-dist/doc/latex/getmap/manifest.txt
+++ b/Master/texmf-dist/doc/latex/getmap/manifest.txt
@@ -12,4 +12,5 @@ getmap.sty
getmap.cfg
getmap-example.tex
getmapdl.lua
+gpx2gps
manifest.txt