Break out common pieces from TeleGPS and AltusMetrum

This creates shared files for portions of the TeleGPS and AltusMetrum
manual to avoid duplicating text between the two.

Signed-off-by: Keith Packard <keithp@keithp.com>

1 files changed, 60 insertions, 0 deletions

diff --git a/doc/load-maps.inc b/doc/load-maps.inc
new file mode 100644
index 00000000..e7717d89
--- /dev/null
+++ b/doc/load-maps.inc
@@ -0,0 +1,60 @@
+=== Load Maps
+
+	.Load Maps Window
+	image::load-maps.png[width="5.2in"]
+
+	Before heading out to a new launch site, you can use
+	this to load satellite images in case you don't have
+	internet connectivity at the site.
+
+	There's a drop-down menu of launch sites we know
+	about; if your favorites aren't there, please let us
+	know the lat/lon and name of the site. The contents of
+	this list are actually downloaded from our server at
+	run-time, so as new sites are sent in, they'll get
+	automatically added to this list.  If the launch site
+	isn't in the list, you can manually enter the lat/lon
+	values
+
+	There are four different kinds of maps you can view;
+	you can select which to download by selecting as many
+	as you like from the available types:
+
+	Hybrid::
+	A combination of satellite imagery and road data. This
+	is the default view.
+
+	Satellite::
+	Just the satellite imagery without any annotation.
+
+	Roadmap::
+	Roads, political boundaries and a few geographic
+	features.
+
+	Terrain::
+	Contour intervals and shading that show hills and
+	valleys.
+
+	You can specify the range of zoom levels to download;
+	smaller numbers show more area with less
+	resolution. The default level, 0, shows about
+	3m/pixel. One zoom level change doubles or halves that
+	number. Larger zoom levels show more detail, smaller
+	zoom levels less.
+
+	The Map Radius value sets how large an area around the
+	center point to download. Select a value large enough
+	to cover any plausible flight from that site. Be aware
+	that loading a large area with a high maximum zoom
+	level can attempt to download a lot of data. Loading
+	hybrid maps with a 10km radius at a minimum zoom of -2
+	and a maximum zoom of 2 consumes about 120MB of
+	space. Terrain and road maps consume about 1/10 as
+	much space as satellite or hybrid maps.
+
+	Clicking the 'Load Map' button will fetch images from
+	Google Maps; note that Google limits how many images
+	you can fetch at once, so if you load more than one
+	launch site, you may get some gray areas in the map
+	which indicate that Google is tired of sending data to
+	you. Try again later.