summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/mercatormap/mercatormap.doc.maptiles.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2020-08-07 03:02:55 +0000
committerNorbert Preining <norbert@preining.info>2020-08-07 03:02:55 +0000
commit3710c23789342d9d88783cbe9ad23eb5263a7c33 (patch)
tree1c40b2bfb9f6b652f7877ad0991f5d6b44391154 /macros/latex/contrib/mercatormap/mercatormap.doc.maptiles.tex
parentd99fea72e367e8d4d2809b43b3b0206b1bb526b8 (diff)
CTAN sync 202008070302
Diffstat (limited to 'macros/latex/contrib/mercatormap/mercatormap.doc.maptiles.tex')
-rw-r--r--macros/latex/contrib/mercatormap/mercatormap.doc.maptiles.tex96
1 files changed, 68 insertions, 28 deletions
diff --git a/macros/latex/contrib/mercatormap/mercatormap.doc.maptiles.tex b/macros/latex/contrib/mercatormap/mercatormap.doc.maptiles.tex
index b038b3d619..9786414753 100644
--- a/macros/latex/contrib/mercatormap/mercatormap.doc.maptiles.tex
+++ b/macros/latex/contrib/mercatormap/mercatormap.doc.maptiles.tex
@@ -220,6 +220,8 @@ accompanying Python script. The technical background is documented in
\end{itemize}
\end{docMrcKey}
+\pagebreak
+
\begin{docMrcKey}[supply]{zoom}{=\meta{setup zoom}}{no default, initially |9|}
Map tile zoom factor alias $z$ coordinate of the map tiles.
Used for map types \docValue{boundaries} and \docValue{reference}.
@@ -250,26 +252,60 @@ accompanying Python script. The technical background is documented in
\end{docMrcKey}
-\begin{docMrcKey}[supply]{area}{=\marg{comma separated list of named positions}}{no default}
+\begin{docMrcKeys}[
+ doc keypath = supply,
+ doc parameter = {=\marg{comma separated list of named positions}},
+ doc description = {no default},
+ %doc new = 2020-05-04,
+]{
+ { doc name = area },
+ { doc name = add area },
+}
Sets
\refKey{/mermap/supply/north}, \refKey{/mermap/supply/south},
\refKey{/mermap/supply/west}, \refKey{/mermap/supply/east}
according to the given \meta{comma separated list of named positions}, i.e.
- the described area contains all these positions.
- Note that you need at least two points inside the list.
+ the described area contains all these positions.\\
+ \refKey{/mermap/supply/area} resets the current area which requires
+ at least two points inside the list.\\
+ \refKey{/mermap/supply/add area} does not reset the current area,
+ i.e. the positions are added to the
+ current area which possibly grows to fit all positions.\\
Also note to take special care, if the international dateline is on your
resulting map, see \Fullref{sec:dateline}.
- Used for map types \docValue{boundaries} and \docValue{areafit}.
-\end{docMrcKey}
+ Used for map types \docValue{boundaries} and \docValue{areafit}
+ or in combination with \refKey{/mermap/supply/area to reference} also
+ for for map type \docValue{reference}.
+\end{docMrcKeys}
-\begin{docMrcKey}[supply]{add area}{=\marg{comma separated list of named positions}}{no default}
- Nearly identical to \refKey{/mermap/supply/area}, but
- the given \meta{comma separated list of named positions}
- does not reset the current area, i.e. the positions are added to the
- current area which possibly grows to fit all positions.
- Used for map types \docValue{boundaries} and \docValue{areafit}.
-\end{docMrcKey}
+
+\begin{docMrcKeys}[
+ doc keypath = supply,
+ doc parameter = {=\marg{file name}},
+ doc description = {no default},
+ doc new = 2020-05-08,
+]{
+ { doc name = area from marker input },
+ { doc name = add area from marker input },
+}
+ Sets
+ \refKey{/mermap/supply/north}, \refKey{/mermap/supply/south},
+ \refKey{/mermap/supply/west}, \refKey{/mermap/supply/east}
+ according to the given \refCom{mrcmarker} positions contained in a
+ file with the given \meta{file name}.\\
+ \refKey{/mermap/supply/area from marker input} resets the current area which requires
+ at least two marker positions inside the file.\\
+ \refKey{/mermap/supply/add area from marker input} does not reset the current area,
+ i.e. the positions are added to the
+ current area which possibly grows to fit all positions.\\
+ Also note to take special care, if the international dateline is on your
+ resulting map, see \Fullref{sec:dateline}.
+ Used for map types \docValue{boundaries} and \docValue{areafit}
+ or in combination with \refKey{/mermap/supply/area to reference} also
+ for for map type \docValue{reference}.
+\end{docMrcKeys}
+
\begin{docMrcKey}[supply]{area to reference}{}{no value, initially unset}
@@ -282,6 +318,7 @@ accompanying Python script. The technical background is documented in
\end{docMrcKey}
+\clearpage
\begin{docMrcKey}[supply]{latitude}{=\meta{setup latitude}}{no default, initially |49|}
Latitude degree of a reference point, possibly negative for the southern hemisphere.
@@ -307,7 +344,7 @@ accompanying Python script. The technical background is documented in
\end{docMrcKey}
-\pagebreak
+
\begin{docMrcKey}[supply]{width}{=\meta{setup width in tiles}}{no default, initially |4|}
Width of the map as multiplicity of map tiles.
Used for map types \docValue{reference} and \docValue{areafit}.
@@ -363,6 +400,18 @@ accompanying Python script. The technical background is documented in
\end{itemize}
\end{docMrcKey}
+\enlargethispage*{1cm}
+
+\begin{docMrcKey}[][doc new=2020-08-06]{fail on missing resource}{\colOpt{=true\textbar false}}{default |true|, initially |true|}
+ If set to |true|, compilation stops with an error, if
+ \refKey{/mermap/supply/target} and \refKey{/mermap/mapdef/resource} are different.
+ Typically, this means that something went wrong while trying to download
+ map tiles. Set this option temporarily to |false|,
+ if the map tile service or the internet
+ connection is expected to be unavailable only temporarily.
+\end{docMrcKey}
+
+
\clearpage
\begin{docMrcKey}[supply]{url}{=\meta{setup URL}}{no default, initially empty}
@@ -671,15 +720,6 @@ want to add more to avoid any legal uncertainties.
\mapexample{opentopomap}{opentopomap}
\clearpage
- \item\docValue{openrouteservice mapsurfer}:\\
- Tile server of \href{https://openrouteservice.org/}{OpenRouteService}.\\
- A registered \meta{api-key} is needed (free plan available)
- which is applied by\\
- \refCom{mrcsetapikey}\brackets{\docValue{openrouteservice}}\marg{api-key}.\\
- Usage: \url{https://openrouteservice.org/terms-of-service/}\\
- API documentation: \url{https://openrouteservice.org/dev/#/api-docs}
- \mapexample{openrouteservice mapsurfer}{openrouteservice_mapsurfer}
-
\item\docValue{stamen terrain}:\\
Tile server of \href{http://stamen.com}{Stamen Design}.\\
Usage: \url{http://maps.stamen.com/#terrain}
@@ -690,12 +730,12 @@ want to add more to avoid any legal uncertainties.
Usage: \url{http://maps.stamen.com/#terrain-background}
\mapexample{stamen terrain-background}{stamen_terrain-background}
-\clearpage
\item\docValue{stamen terrain-labels}:\\
Tile server of \href{http://stamen.com}{Stamen Design}.\\
Usage: \url{http://maps.stamen.com/#terrain-labels}
\mapexample{stamen terrain-labels}{stamen_terrain-labels}
+\clearpage
\item\docValue{stamen terrain-lines}:\\
Tile server of \href{http://stamen.com}{Stamen Design}.\\
Usage: \url{http://maps.stamen.com/#terrain-lines}
@@ -706,12 +746,12 @@ want to add more to avoid any legal uncertainties.
Usage: \url{http://maps.stamen.com/#toner}
\mapexample{stamen toner}{stamen_toner}
-\clearpage
\item\docValue{stamen toner-lite}:\\
Tile server of \href{http://stamen.com}{Stamen Design}.\\
Usage: \url{http://maps.stamen.com/#toner-lite}
\mapexample{stamen toner-lite}{stamen_toner-lite}
+\clearpage
\item\docValue{stamen toner-hybrid}:\\
Tile server of \href{http://stamen.com}{Stamen Design}.\\
Usage: \url{http://maps.stamen.com/#toner-hybrid}
@@ -722,12 +762,12 @@ want to add more to avoid any legal uncertainties.
Usage: \url{http://maps.stamen.com/#toner-background}
\mapexample{stamen toner-background}{stamen_toner-background}
-\clearpage
\item\docValue{stamen toner-labels}:\\
Tile server of \href{http://stamen.com}{Stamen Design}.\\
Usage: \url{http://maps.stamen.com/#toner-labels}
\mapexample{stamen toner-labels}{stamen_toner-labels}
+\clearpage
\item\docValue{stamen toner-lines}:\\
Tile server of \href{http://stamen.com}{Stamen Design}.\\
Usage: \url{http://maps.stamen.com/#toner-lines}
@@ -738,7 +778,6 @@ want to add more to avoid any legal uncertainties.
Usage: \url{http://maps.stamen.com/#watercolor}
\mapexample{stamen watercolor}{stamen_watercolor}
-\clearpage
\item\docValue{thunderforest opencyclemap}:\\
Tile server of \href{https://www.thunderforest.com}{Thunderforest}.\\
A registered \meta{api-key} is needed (free plan available)
@@ -750,6 +789,7 @@ want to add more to avoid any legal uncertainties.
\end{itemize}
\mapexample{thunderforest opencyclemap}{thunderforest_opencyclemap}
+\clearpage
\item\docValue{thunderforest transport}:\\
Tile server of \href{https://www.thunderforest.com}{Thunderforest}.\\
A registered \meta{api-key} is needed (free plan available)
@@ -772,7 +812,6 @@ want to add more to avoid any legal uncertainties.
\end{itemize}
\mapexample{thunderforest landscape}{thunderforest_landscape}
-\clearpage
\item\docValue{thunderforest outdoors}:\\
Tile server of \href{https://www.thunderforest.com}{Thunderforest}.\\
A registered \meta{api-key} is needed (free plan available)
@@ -784,6 +823,7 @@ want to add more to avoid any legal uncertainties.
\end{itemize}
\mapexample{thunderforest outdoors}{thunderforest_outdoors}
+\clearpage
\item\docValue{thunderforest transport-dark}:\\
Tile server of \href{https://www.thunderforest.com}{Thunderforest}.\\
A registered \meta{api-key} is needed (free plan available)
@@ -806,7 +846,6 @@ want to add more to avoid any legal uncertainties.
\end{itemize}
\mapexample{thunderforest spinal-map}{thunderforest_spinal-map}
-\clearpage
\item\docValue{thunderforest pioneer}:\\
Tile server of \href{https://www.thunderforest.com}{Thunderforest}.\\
A registered \meta{api-key} is needed (free plan available)
@@ -818,6 +857,7 @@ want to add more to avoid any legal uncertainties.
\end{itemize}
\mapexample{thunderforest pioneer}{thunderforest_pioneer}
+\clearpage
\item\docValue{thunderforest mobile-atlas}:\\
Tile server of \href{https://www.thunderforest.com}{Thunderforest}.\\
A registered \meta{api-key} is needed (free plan available)