CONFIGURATION INDEX
| Item | Configuration |
|---|---|
| Document | swathplanner.html |
| Markdown source / build | swathplanner_R02.md / B261109 |
| File revision / build | R003 / B261109 |
| Content revision / build | R001 / B261013 |
| Date | 2026-11-09 |
| Approved source application | SPOTMAP v0.9.9R01 FIX1 |
| Standalone application | n/a |
| Source display / package build | B261013 / 2026101303 |
| Standalone package build | n/a |
| Status | Prepared for project-owner review; not uploaded. |
Generic information
- The offline app help stays available even when not connected to internet.
- The online web help requires an internet connection.
- This is a reference tool only and not a substitute for knowledge, experience or approved operational data; always strictly use, adhere, follow and verify with approved operational data.
- If you do not have a FULL understanding of the tool, do not use it!
How to use the help section
🔴Disclaimer: A disclaimer is a legal statement designed to limit a company's liability or specify the boundaries of a product's warranty. It informs the user about what the product or company is not responsible for, or clarifies that certain information (like third-party software updates) is outside of the company's control. Impact: Legal/Financial. It protects the organization from lawsuits and sets realistic expectations for the product's performance or usage.
⚠️Warning: A warning alerts the user to potential hazards that could result in personal injury, death, severe data loss, or permanent damage to equipment. It is the most critical type of callout and must clearly explain the hazard, the consequences of ignoring it, and how to avoid it. Impact: High. Ignoring a warning can lead to physical harm or catastrophic system failure, or both.
🔼 Note: A note provides helpful, non-critical information to the user. It emphasizes points, clarifies steps, or offers background context that is not essential to completing the main task but improves the user's understanding. Impact: Low. Ignoring a note will not cause harm, damage, or data loss.
INTRODUCTION
SWATH PLANNER creates and edits survey-area boundaries on a map. It saves local projects, displays imported references, and exports KML/KMZ for use with SPOTMAP or compatible viewers.
BASIC USAGE
Open TOOLS → SWATH PLANNER. The planner opens full screen and uses SPOTMAP's existing ground-speed and recorder-status information.
1. Complete the access check
When ground speed is above 10 kt, or the main session is Recording/Paused, the planner requests confirmation that you are a copilot/passenger and are not at the controls. YES permits the current planner session; NO returns to the welcome screen.
If speed is unavailable or stale, choose I AM STATIONARY, COPILOT/PASSENGER, or CANCEL as appropriate. Stationary confirmation is your statement, not a measured speed indication. The check repeats on a new opening or return from the background, and if conditions require it while editing.
The map background needs internet through Wi-Fi or cellular data. Local draft editing, saving, and exporting do not depend on downloading new imagery. Read the network/footer status if tiles load slowly; switching STREET/SATELLITE can help distinguish a missing background from missing local geometry.
2. Find the area — Lat, Lon, and map controls
Pan and pinch to zoom. Alternatively, enter signed decimal Lat and Lon, then tap the return-arrow beside Longitude or the keyboard GO TO COORDINATES/Go action. South and west use a minus sign. Centering the map on coordinates does not add a boundary point.
Use STREET or SATELLITE for the background; changing the background keeps the map position. The fit icon shows all planner areas. The map display is limited near the poles.
3. NEW and drawing an area
Tap NEW and enter a name of 1–10 characters. Tap around the perimeter in boundary order. Three valid points create the orange polygon; continue up to 50 points. The last vertex connects back to the first automatically.
Crossing edges, duplicate/invalid boundary geometry, and overlapping edges within one area are rejected. Concave boundaries are supported. Read the validation message rather than assuming a rejected point was saved. If you request another NEW area while the current one is incomplete, respond to the prompt about that unfinished boundary.
4. SAVE the project
Accepted edits are saved automatically as the current draft. SAVE finishes editing and saves all valid areas as one named project. An incomplete area must be resolved before saving a complete project. Saving an already open project updates its saved copy.
Use the upper-right menu's Open Saved Projects to reopen a project. Opening another project preserves a nonempty current draft as a recovery project.
🔼 Note: Automatic draft protection and a named saved project are different. Save a project or export before deliberately clearing the workspace.
5. EXPORT and RESET — upper control row
EXPORT opens the two export choices:
- SAVE KML exports complete planner areas only. Use this option to create target boundaries for SPOTMAP SWATH.
- SAVE KMZ exports the visible geographic workspace: planner areas and visible imported layers, including their packaged icons and polygon holes. Hidden reference layers are excluded. Visible layers are exported in full, even outside the current map view. Unfinished one-/two-point planner areas are represented separately as a point or line.
The app saves a local export before opening the sharing panel. Use Save to Files for the desired destination. Apple Maps imagery is not included.
RESET asks for confirmation. RESET WORKSPACE removes all current planner areas; CANCEL retains them. Saved projects, exports, map position/background, and imported reference layers remain. RESET is disabled when there are no current areas.
6. Area menu, EDIT AREA, and BROWSE — second row
Use the area menu to select an area, Rename Area, or Delete Area. Selecting another area keeps the current edit/browse mode.
- EDIT AREA lets map taps append boundary points to the selected area. Tap a numbered pin to select it; hold and drag it to move it.
- BROWSE prevents map taps from adding points, making map inspection easier.
- UNDO LAST removes the last boundary point in edit mode; it is not a universal undo history for every action.
- DELETE POINT removes the selected vertex in edit mode.
The active mode is bright green and is also named in the map label. Undo/Delete Point are disabled in Browse. A move or deletion that creates invalid geometry is rejected with an explanation.
7. IMPORT reference layers
Tap IMPORT to select KML/KMZ references. Imported points, lines, and polygons provide context; they are separate from your editable planner areas.
- KML points use cyan squares.
- KMZ points can use packaged icons with their supported tint, scale, heading, and anchor.
- Supported line/fill colors, opacity, width, and polygon fill/outline are retained.
- The reference card provides FIT, HIDE/SHOW, and REMOVE for each reference layer.
- Missing/unsupported artwork falls back to a cyan square with a note. Online icon artwork requires a connection when first fetched and may then be cached.
Reference layers remain across RESET and backgrounding. They are cleared by the editor's exit/close workflow described below. Removing a reference does not delete its original file in Files.
8. Numbered point list and exact coordinate edits
Tap the numbered-list button to inspect the selected area's vertices. Tap a point card, edit signed decimal latitude/longitude, then use APPLY. The point keeps its place in the boundary sequence.
CANCEL leaves it unchanged. Invalid coordinates and invalid resulting geometry are rejected. Manual point-coordinate editing is available in either Browse or Edit Area and does not change that mode.
9. Header menu and status
The upper-right menu provides Open Saved Projects, Fit All Areas, Imported References, Fit Areas and References, and Help. The separate ? also opens offline help.
The footer reports edit/save errors, network/map status, and current speed information. A missing connection can trigger a network alert; a slow map-service response does not necessarily mean all local editing has stopped.
10. Close from the editor or return from the welcome screen
⚠️Warning: The editor's top-right X performs the planner exit action: it clears current planner areas, imported references, and automatic draft copies before returning to SPOTMAP. SAVE a project or EXPORT first when you want to keep the current work. Saved projects, exports, and original imported files remain.
The welcome/access screen's RETURN TO SPOTMAP or X instead returns with the protected draft retained. Backgrounding also protects the draft and requires a new access check on return. These actions have different effects from the editor's deliberate exit.
11. Use the result in SWATH
Planner target polygons use NOT VIEWED orange #FFAA00 at 80% fill opacity, with the original orange boundary at full opacity. Export complete areas as KML, return to the main screen, and import that KML through the normal reference-import route. Open SWATH to confirm the areas were recognized before recording coverage.
ABBREVIATION
- DD — Decimal Degrees.
- GPS — Global Positioning System.
- JPG / JPEG — Joint Photographic Experts Group image format.
- KML — Keyhole Markup Language.
- KMZ — A ZIP archive containing KML and any packaged resources.
- kt — Knot.
- Lat / Lon — Latitude / Longitude.
- PNG — Portable Network Graphics.
DEFINITION
- Area — One editable target polygon defined by ordered boundary points.
- Vertex — One point in an area's boundary.
- Concave polygon — A boundary containing an inward indentation without crossing itself.
- Project — A named saved collection of planner areas.
- Draft — The automatically protected current editing workspace.
- Reference layer — Imported map information used as context, separate from editable planner areas.
- Visible workspace export — KMZ output containing all visible geographic layers, not a screenshot or map-imagery download.
- Passenger mode — Access confirmed for someone who is not currently at the controls.
