PILOT PLUG USER MAP AUTHORING KIT v1.0.2
===========================================

This kit creates offline Pilot Plug .ppmap User Maps on a Windows PC.

QUICK WORKFLOW

1. Install QGIS 3.40 or newer.

2. Open PowerShell in this folder and run:

   powershell -ExecutionPolicy Bypass -File .\SETUP_AUTHORING_KIT.ps1

3. Create your map configuration:

   powershell -ExecutionPolicy Bypass -File .\CONFIGURE_USER_MAP.ps1

4. Set up the offline basemap tools:

   powershell -ExecutionPolicy Bypass -File .\SETUP_BASEMAP_TOOLS.ps1

5. Generate the offline basemap:

   powershell -ExecutionPolicy Bypass -File .\GENERATE_BASEMAP.ps1

   The kit automatically selects the smallest Geofabrik extract that contains
   your configured West/South/East/North bounds. You do not need to know or
   type a Geofabrik area name.

   Advanced/manual override only:

   powershell -ExecutionPolicy Bypass -File .\GENERATE_BASEMAP.ps1 -Area lithuania

6. Open:

   project\PilotPlug_UserMap_v1.qgz

   The project now shows a read-only "Pilot Plug — User Map Boundary"
   reference rectangle generated from your configured West/South/East/North.
   Keep every authored point and every line/polygon vertex inside it.

   Add your Pilot Plug points, lines and areas in QGIS.

   IMPORTANT:
   Save/commit layer edits before building.
   Every authored object must lie inside the configured map bounds.

7. Build the final User Map:

   powershell -ExecutionPolicy Bypass -File .\BUILD_USER_MAP.ps1

8. The finished .ppmap is written to:

   output\

9. Copy the .ppmap to the Android device and import it in Pilot Plug.

OFFLINE BEHAVIOR

QGIS may use OpenStreetMap as an online reference while authoring.
That online reference is not automatically included in the .ppmap.

GENERATE_BASEMAP.ps1 creates the offline PMTiles basemap that is packaged
with your User Map. After the completed .ppmap is imported into Pilot Plug,
the map is designed to work without internet access.

IMPORTANT FILES

SETUP_AUTHORING_KIT.ps1
  Detects QGIS and creates tools\qgis_runtime.json.

CONFIGURE_USER_MAP.ps1
  Creates config\build_config.json, generates the read-only QGIS User Map
  Boundary, and updates the QGIS initial view to the configured area.

SETUP_BASEMAP_TOOLS.ps1
  Sets up Java 21 and the frozen Planetiler basemap generator.

GENERATE_BASEMAP.ps1
  Creates build\map.pmtiles.

project\PilotPlug_UserMap_v1.qgz
  QGIS authoring project.

BUILD_USER_MAP.ps1
  Exports QGIS semantic data, builds the .ppmap, and runs the independent
  package validator.

For the full instructions and object list, see:

  docs\USER_GUIDE.md

Pilot Plug User Maps are user-created reference maps. They are not official
electronic navigational charts and do not replace approved navigation systems.
