iiab/roles/osm-vector-maps/README.md

What's New with IIAB Maps for the IIAB 7.2 Release?

1. If you install IIAB 7.2 with IIAB Maps, a new Install IIAB Maps page is available (http://box/osm-vector-maps/installer/) with instructions, separate from IIAB's Admin Console:

   1. This very visual page facilitates selecting/downloading/installing of Map Pack(s) for your favorite "continent(s)". (SEE 2. BELOW)
   2. If you've installed at least one Map Pack, you can then use this same page to select/download/install Hi-Res Satellite Photo Region(s) for your local communities. (SEE 3. BELOW)

2. Map Packs no longer bundle both data and program in a .zip file. All Map Packs are really now just a collection of 3 .mbtiles files:

   1. The main focus of a Map Pack remains Hi-Res Vector Map data from OpenStreetMap, for your selected "continent" — but Lo-Res vector map tiles (1.74GB .mbtiles) and Lo-Res satellite photos (932MB .mbtiles) are also included for the entire planet. Read more at: https://github.com/iiab/iiab/wiki/IIAB-Maps
   2. Map Packs' OSM vector tile data (originally from 2017) was updated to September 2019.
   3. The world view (planetwide OSM vector maps included with all Map Packs) increased zoom levels from 0-9 to 0-10 (1.74GB osm-planet_z0-z10_2019.mbtiles) so that city search is successful more of the time.
   4. Multiple Map Packs can be downloaded/installed (one "continent" at a time). However this can waste disk space with duplicate data ("continent" bounding boxes have been designed to overlap on purpose, so that multiple Map Packs are rarely necessary!)

3. Hi-Res Satellite Photos can be downloaded/installed for any 100 x 100 km, 300 x 300 km, or 1000 x 1000 km square region (around any map point that you click!)

   1. These new Hi-Res Satellite Photo Regions are "squares" with 4 additional levels of satellite photo zoom (i.e. zoom levels 10-13) giving you 16X the resolution (i.e. 19 x 19 m pixels) and 256X more photographic information density.
   2. As compared to Lo-Res Satellite Photos i.e. zooms level 0-9 (305 x 305 m pixels) everywhere else on the planet (932MB satellite_z0-z9_v3.mbtiles is included with all Map Packs). (SEE 2. ABOVE)
   3. Multiple Hi-Res Satellite Photo Regions can be downloaded/installed (one "square" region at a time, thankfully duplicate disk space is avoided when such "squares" overlap!)

4. Some variables have newer meanings:

   1. osm_vector_maps_install in /etc/iiab/local_vars.yml means install the map program and 7 levels of zoom (about 40MB ?)
   2. osm_vector_maps_enabled in /etc/iiab/local_vars.yml is once again standardized, solving #2484 install delays.
   3. osm_vector_maps_installed in /etc/iiab/iiab_state.yml means a functioning world map with 7 levels of zoom (z0-z6) has been installed — i.e. a preview of IIAB's mapping system that helps you select Maps Pack(s) and Hi-Res Satellite Photo Region(s) to download and install on your IIAB. (SEE 1. ABOVE)

5. Drag-and-Drop Map Overlays — try this by dragging and dropping any relevant GeoJSON file onto the IIAB Maps (http://box/maps) in your browser! For example try this GeoJSON file, to explore the shape of gerrymandered US Congressional districts: https://eric.clst.org/assets/wiki/uploads/Stuff/gz_2010_us_500_11_20m.json

6. Separately: Students can right click on IIAB Maps (http://box/maps) to add descriptions and photos of local points of interest — and then save and restore them using their local browser. [CAN ANYBODY SUGGEST STUDENT/TEACHER GEOGRAPHIC ADVENTURE & LOCAL EXPLORATION TIPS THAT WORK ON PHONES?]

Please also see the IIAB Maps doc: https://github.com/iiab/iiab/wiki/IIAB-Maps